عرض مصدر JavaScript/Promise/all

<noinclude>{{DISPLAYTITLE:الدالة <code>Promise.all()‎</code> في JavaScript}}</noinclude>
الدالة <code>Promise.all(iterable)‎</code> تُعيد وعدًا <code>[[JavaScript/Promise|Promise]]</code> وحيدًا الذي سيُقبَل (resolves) عندما تكون جميع الوعود في الوسيط <code>iterable</code> مقبولة، أو عندما يكون المعامل <code>iterable</code> لا تحتوي على أيّ وعود. وسيُرفَض مع سبب أول وعد مرفوض.<syntaxhighlight lang="javascript">
var promise1 = Promise.resolve(3);
var promise2 = 42;
var promise3 = new Promise(function(resolve, reject) {
  setTimeout(resolve, 100, 'foo');
});

Promise.all([promise1, promise2, promise3]).then(function(values) {
  console.log(values);
});
// Array [3, 42, "foo"]
</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="javascript">
Promise.all(iterable);
</syntaxhighlight>

== المعاملات ==

=== <code>iterable</code> ===
كائن قابل للتكرار (iterable) مثل <code>[[JavaScript/Array|Array]]</code> أو <code>[[JavaScript/String|String]]</code>.

== القيمة المعادة ==
* وعد <code>Promise</code> مقبول (already resolved) إذا كان <code>iterable</code> المُمرَّر فارغًا.

* وعد <code>Promise</code> مقبول غير تزامنيًا (asynchronously resolved) إذا كان <code>iterable</code> لا تحتوي على أي وعود. لاحظ أنَّ متصفح Chrome 58 يعيد وعدًا مقبولًا (already resolved) في هذه الحالة.

* وعد <code>Promise</code> في الانتظار (pending). هذا الوعد المعادي سيقبل أو يرفض بشكل غير متزامن (فور فراغ المكدس) عند قبول جميع الوعود في <code>iterable</code> أو في حال رفض أحدها.

== الوصف ==
هذه الدالة مفيدة في معرفة نتائج عدّة وعود.

=== حالة القبول ===
إذا مرر <code>iterable</code> فارغ، فستعيد هذه الدالة وعدًا مقبولًا (already resolved promise). وإذا قبلت جميع الوعود، أو لم تكن هنالك مكونات <code>iterable</code> هي وعود، فإن الوعد المعاد من الدالة <code>Promise.all</code> هو وعدٌ مقبول بشكل غير متزامن (fulfilled asynchronously).

في جميع الحالات، الوعد المعاد يقبل مع مصفوفة تحتوي على جميع قيم <code>iterable</code> المُمرَّر كمعامل (حتى القيم التي ليست وعودًا.

=== حالة الرفض ===
إذا رفض أي من الوعود المُمرَّرة، فإن الدالة <code>Promise.all</code> ستُرفَض بشكل غير متزامن مع قيمة الوعود التي رفضت، سواءً كانت بقية الوعود مقبولة أم لا.

== أمثلة ==
تنتظر الدالة <code>()Promise.all</code> لقبول جميع الوعود (أو لأول رفض):<syntaxhighlight lang="javascript">
var p1 = Promise.resolve(3);
var p2 = 1337;
var p3 = new Promise((resolve, reject) => {
  setTimeout(resolve, 100, 'foo');
}); 

Promise.all([p1, p2, p3]).then(values => { 
  console.log(values); // [3, 1337, "foo"] 
});
</syntaxhighlight>إذا لم يحتو <code>iterable</code> على قيم تُمثِّل وعودًا، فسيتم تجاهلها، لكنها ستبقى موجودةً في المصفوفة المعادة عند قبول الوعد:<syntaxhighlight lang="javascript">
// الممرر فارغًا، لذا سيتحقق الوعد iterable هذا سيعد أن
var p = Promise.all([1,2,3]);
// الُممرر يحوي وعدًا مقبولًا مع القيمة "444"، لذا سيتحقق الوعد iterable هذا سيعد أن
var p2 = Promise.all([1,2,3, Promise.resolve(444)]);
// الممرر يحوي وعدًا مرفوضًا مع القيمة "555"، لذا سيرفض الوعد iterable هذا سيعد أن
var p3 = Promise.all([1,2,3, Promise.reject(555)]);

// بعد أن يفرغ المكدس setTimeout يمكننا تنفيذ شيفرة باستعمال
setTimeout(function() {
    console.log(p);
    console.log(p2);
    console.log(p3);
});

// :يسجل
// Promise { <state>: "fulfilled", <value>: Array[3] }
// Promise { <state>: "fulfilled", <value>: Array[4] }
// Promise { <state>: "rejected", <reason>: 555 }
</syntaxhighlight>

== المصادر ==
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all صفحة Promise.all()‎ في توثيق MDN الرسمي].
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Functions]]
[[تصنيف:JavaScript Promise]]