عرض مصدر JavaScript/Array/reduceRight

<noinclude>{{DISPLAYTITLE:<code>Array.prototype.reduceRight()‎</code>}}</noinclude>
الدالة <code>Array.prototype.reduceRight()‎</code> تؤدي إلى اختزال جميع قيم المصفوفة (بدءًا من اليمين إلى اليسار) إلى قيمة واحدة.<syntaxhighlight lang="javascript">
var flattened = [[0, 1], [2, 3], [4, 5]].reduceRight(function(a, b) {
    return a.concat(b);
}, []);

// [4, 5, 2, 3, 0, 1]

</syntaxhighlight>انظر صفحة الدالة <code>[[JavaScript/Array/reduce|Array.prototype.reduce()‎]]</code> لاختزال القيم من اليسار إلى اليمين.

== البنية العامة ==
<syntaxhighlight lang="javascript">
arr.reduceRight(callback[, initialValue])

</syntaxhighlight>

=== <code>callback</code> ===
الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل أربعة وسائط.

==== <code>previousValue</code> ====
القيمة السابقة، انظر النقاش أدناه للتفاصيل.

==== <code>currentValue</code> ====
العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة.

==== <code>currentIndex</code> ====
فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية.

==== <code>array</code> ====
المصفوفة التي استدعيت الدالة <code>reduce</code> عليها، وهذه القيمة اختيارية.

=== <code>initialValue</code> ===
القيمة التي ستُستخدم كوسيط لأوّل استدعاء للدالة <code>callback</code>، وإن لم توفَّر هذه القيمة فسيستخدم أوّل عنصر في المصفوفة.

=== القيمة المعادة ===
القيمة الناتجة من عملية الاختزال.

== الوصف ==
الدالة <code>reduceRight</code> تستدعي الدالة <code>callback</code> مرةً واحدةً لكل عنصر في المصفوفة، باستثناء الفجوات الموجودة في المصفوفة، وهذه الدالة تقبل أربعة وسائط:
* <code>accumulator</code>
* <code>currentValue</code>
* <code>currentIndex</code>
* <code>array</code>
في أوّل استدعاء للدالة <code>callback</code>، تكون <code>previousValue</code> و <code>currentValue</code> قيمةً من قيمتين. فإذا وفّرنا قيمةً للوسيط <code>initialValue</code> عند استدعاء <code>reduceRight</code> فستكون <code>previousValue</code> مساويةً إلى <code>initialValue</code>، وستكون <code>currentValue</code> مساويةً إلى آخر عنصر في المصفوفة؛ أما إذا لم تكن قيمة الوسيط <code>initialValue</code> موجودةً، فستكون <code>previousValue</code> مساويةً لآخر قيمة في المصفوفة، و <code>currentValue</code> ستساوي القيمة قبل الأخيرة.

إذا كانت المصفوفة فارغة ولم توفَّر قيمة <code>initialValue</code>، فسيرمى الاستثناء <code>[[JavaScript/TypeError|TypeError]]</code>، وإذا احتوت المصفوفة على عنصرٍ وحيد (بغض النظر عن موضعه) ولم توفَّر قيمة <code>initialValue</code> أو كانت القيمة <code>initialValue</code> موجودةً لكن المصفوفة فارغة، فستُعاد القيمة الوحيدة دون استدعاء الدالة <code>callback</code>.

لنفترض أنَّ لدينا المثال الآتي:<syntaxhighlight lang="javascript">
[0, 1, 2, 3, 4].reduceRight(function(previousValue, currentValue, index, array) {
  return previousValue + currentValue;
});

</syntaxhighlight>ستُستدعى الدالة <code>callback</code> أربع مرات، وسنستعرض الوسائط الممررة إليها والقيم التي تعيدها في الجدول الآتي:
{| class="wikitable"
!callback
!accumulator
!currentValue
!currentIndex
!array
!القيمة المعادة
|-
|أوّل استدعاء
|<code>4</code>
|<code>3</code>
|<code>3</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>7</code>
|-
|ثاني استدعاء
|<code>7</code>
|<code>2</code>
|<code>2</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>9</code>
|-
|ثالث استدعاء
|<code>9</code>
|<code>1</code>
|<code>1</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>10</code>
|-
|رابع استدعاء
|<code>10</code>
|<code>0</code>
|<code>0</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>10</code>
|}
القيمة المعادة من الدالة <code>reduceRight</code> هي آخر قيمة مُعادة من الدالة <code>callback</code> (وهي <code>10</code>).

أما إذا وفّرتَ قيمةً ابتدائيةً كوسيطٍ ثانٍ للدالة <code>reduceRight</code>، أي أنَّ الشيفرة كالآتية:<syntaxhighlight lang="javascript">
[0, 1, 2, 3, 4].reduceRight(function(previousValue, currentValue, index, array) {
  return previousValue + currentValue;
}, 10);

</syntaxhighlight>الجدول:
{| class="wikitable"
!callback
!accumulator
!currentValue
!currentIndex
!array
!القيمة المعادة
|-
|أوّل استدعاء
|<code>10</code>
|<code>4</code>
|<code>4</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>14</code>
|-
|ثاني استدعاء
|<code>14</code>
|<code>3</code>
|<code>3</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>17</code>
|-
|ثالث استدعاء
|<code>17</code>
|<code>2</code>
|<code>2</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|20
|-
|رابع استدعاء
|<code>20</code>
|<code>0</code>
|<code>0</code>
|<code>‎[0, 1, 2, 3, 4]‎‎</code>
|<code>20</code>
|}
القيمة المعادة من الدالة <code>reduceRight</code> في هذه الحالة هي 20.

== أمثلة ==

=== جمع كل القيم في المصفوفة ===
<syntaxhighlight lang="javascript">
var sum = [0, 1, 2, 3].reduceRight(function(a, b) {
  return a + b;
});
// 6
</syntaxhighlight>
=== تسطيح مصفوفة من المصفوفات ===
<syntaxhighlight lang="javascript">
var flattened = [[0, 1], [2, 3], [4, 5]].reduceRight(function(a, b) {
    return a.concat(b);
}, []);
// [4, 5, 2, 3, 0, 1]

</syntaxhighlight>
=== الفرق بين <code>reduce</code> و <code>reduceRight</code> ===
<syntaxhighlight lang="javascript">
var a = ['1', '2', '3', '4', '5']; 
var left  = a.reduce(function(prev, cur)      { return prev + cur; }); 
var right = a.reduceRight(function(prev, cur) { return prev + cur; }); 

console.log(left);  // "12345"
console.log(right); // "54321"

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
أضيفت هذه الدالة في الإصدار الخامس من معيار ECMAScript، لذا يمكنك استخدام الشيفرة الآتية لإضافتها للمتصفحات التي لا تدعمها:<syntaxhighlight lang="javascript">
// Production steps of ECMA-262, Edition 5, 15.4.4.22
// Reference: http://es5.github.io/#x15.4.4.22
if ('function' !== typeof Array.prototype.reduceRight) {
  Array.prototype.reduceRight = function(callback /*, initialValue*/) {
    'use strict';
    if (null === this || 'undefined' === typeof this) {
      throw new TypeError('Array.prototype.reduce called on null or undefined');
    }
    if ('function' !== typeof callback) {
      throw new TypeError(callback + ' is not a function');
    }
    var t = Object(this), len = t.length >>> 0, k = len - 1, value;
    if (arguments.length >= 2) {
      value = arguments[1];
    } else {
      while (k >= 0 && !(k in t)) {
        k--;
      }
      if (k < 0) {
        throw new TypeError('Reduce of empty array with no initial value');
      }
      value = t[k--];
    }
    for (; k >= 0; k--) {
      if (k in t) {
        value = callback(value, t[k], k, t);
      }
    }
    return value;
  };
}

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|9
|10.5
|4
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-array.prototype.reduceright ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.reduceright ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.4.4.22 ECMAScript 5.1]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Array|{{SUBPAGENAME}}]]