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

<noinclude>{{DISPLAYTITLE:الدالة <code>Promise.resolve()‎</code>}}</noinclude>
الدالة <code>Promise.resolve(value)‎</code> ستُعيد كائن <code>[[JavaScript/Promise|Promise]]</code> الذي قُبِل (resolved) مع القيمة <code>value</code> المُحدَّدة. إذا كانت القيمة هي وعدٌ، فسيُعاد ذاك الوعد. وإذا كانت القيمة تمتلك استدعاءً للدالة <code>[[JavaScript/Promise/prototype/then|then]]</code>، «فسيتبع» الوعد المُعاد ذاك الاستدعاء، وسيُعيد حالته النهائية؛ وفيما عدا ذلك من الحالات، سيتم تحقيق الوعد مع القيمة المعطية.<syntaxhighlight lang="javascript">
var promise1 = Promise.resolve([1, 2, 3]);

promise1.then(function(value) {
  console.log(value);
  //: Array [1, 2, 3]
});
</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="javascript">
Promise.resolve(value);
Promise.resolve(promise);
Promise.resolve(thenable);
</syntaxhighlight>

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

=== <code>value</code> ===
الوسيط الذي سيُقبل مع هذا الوعد، ويمكن أن يكون كائن <code>[[JavaScript/Promise|Promise]]</code> أو كائن <code>[[JavaScript/Promise|Promise]]</code> مع استدعاء <code>[[JavaScript/Promise/prototype/then|then()‎]]</code> عليه.

== القيمة المعادة ==
سيُقبَل الوعد <code>Promise</code> مع القيمة المعطية، أو إذا مُرِّر وعدٌ آخر كقيمة، فستكون القيمة المُعادة من الوعد هي كائن <code>[[JavaScript/Promise|Promise]]</code> المُمرَّر إليه.

== الوصف ==
الدالة الساكنة <code>()Promise.resolve</code> تُعيد وعدًا [[JavaScript/Promise|<code>Promise</code>]] الذي قد قُبِل (resolved).

== أمثلة ==
استخدام الدالة <code>()Promise.resolve</code>:<syntaxhighlight lang="javascript">
Promise.resolve('Success').then(function(value) {
  console.log(value); // "Success"
}, function(value) {
  // لن تستدع
});
</syntaxhighlight>قبول مصفوفة:<syntaxhighlight lang="javascript">
var p = Promise.resolve([1,2,3]);
p.then(function(v) {
  console.log(v[0]); // 1
});
</syntaxhighlight>قبول كائن [[JavaScript/Promise|<code>Promise</code>]] آخر:<syntaxhighlight lang="javascript">
var original = Promise.resolve(33);
var cast = Promise.resolve(original);
cast.then(function(value) {
  console.log('value: ' + value);
});
console.log('original === cast ? ' + (original === cast));

// سيُطبَع بالترتيب:
// original === cast ? true
// value: 33
</syntaxhighlight>السبب في أنَّ الناتج قد ظهر بترتيبٍ مقلوب هو أنَّ الدوال المستدعاة عبر [[JavaScript/Promise/prototype/then|<code>then()‎</code>]] ستُستدعى بشكل غير متزامن. يمكنك العودة إلى توثيق الدالة [[JavaScript/Promise/prototype/then|<code>then()‎</code>]] للتفاصيل.

قبول كائنات تستعمل <code>[[JavaScript/Promise/prototype/then|then()‎]]</code> ورمي أخطاء:<syntaxhighlight lang="javascript">
// قبول كائن يستعمل الدالة then
var p1 = Promise.resolve({ 
  then: function(onFulfill, onReject) { onFulfill('fulfilled!'); }
});
console.log(p1 instanceof Promise) // true, object casted to a Promise

p1.then(function(v) {
    console.log(v); // "fulfilled!"
  }, function(e) {
    // لن تستدع
});

// سيرمي خطأ قبل قبول الوعد
// سيرفض الوعد
var thenable = { then: function(resolve) {
  throw new TypeError('Throwing');
  resolve('Resolving');
}};

var p2 = Promise.resolve(thenable);
p2.then(function(v) {
  // لن تستدع
}, function(e) {
  console.log(e); // TypeError: Throwing
});

// سيرمى خطأ بعد قبول الوعد
// سيُقبل الوعد
var thenable = { then: function(resolve) {
  resolve('Resolving');
  throw new TypeError('Throwing');
}};

var p3 = Promise.resolve(thenable);
p3.then(function(v) {
  console.log(v); // "Resolving"
}, function(e) {
  // لن تستدع
});
</syntaxhighlight>

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