عرض مصدر JavaScript/await

<noinclude>{{DISPLAYTITLE:المعامل <code>await</code> في JavaScript}}</noinclude>
المعامل <code>await</code> يُستخدَم لانتظار وعد (الكائن <code>[[JavaScript/Promise|Promise]]</code>)، ويمكن أن يُستخدَم داخل [[JavaScript/async function|دالة غير متزامنة]] فقط (async function).
==البنية العامة==
<syntaxhighlight lang="javascript">
[rv] = await expression;

</syntaxhighlight>
=== <code>expression</code> ===
كائن <code>[[JavaScript/Promise|Promise]]</code> أو أيّة قيمة يجب انتظارها.

=== <code>rv</code> ===
إعادة قيمة المُحققة للوعد (الكائن <code>[[JavaScript/Promise|Promise]]</code>)، أو القيمة نفسها إذا لم تكن وعدًا.

== الوصف ==
التعبير <code>await</code> يؤدي إلى إيقاف تنفيذ دالة غير متزامنة (async function) ريثما يتحقق (fulfill) أو يُرفَض (reject) الوعد (الكائن <code>[[JavaScript/Promise|Promise]]</code>)، ويؤدي إلى استئناف تنفيذ الدالة غير المتزامنة بعد أن يتحقق الوعد، وعند استنئاف الدالة ستكون قيمة تعبير <code>await</code> هي القيمة المُحقَّقة للوعد (الكائن <code>[[JavaScript/Promise|Promise]]</code>).

إذا رُفِضَ الوعد، فسيرمي (<code>[[JavaScript/throw|throw]]</code>) التعبير <code>await</code> القيمة المرفوضة.

إذا كانت قيمة التعبير الذي يلي المعامل <code>await</code> ليست وعدًا <code>[[JavaScript/Promise|Promise]]</code>، فستحوَّل إلى وعد باستخدام الدالة <code>[[JavaScript/Promise/resolve|resolve()‎]]</code>.

== أمثلة ==
إذا مُرِّر كائن <code>[[JavaScript/Promise|Promise]]</code> إلى التعبير <code>await</code>، فسينتظر إلى أن يتحقق الوعد ويُعيد تلك القيمة: <syntaxhighlight lang="javascript">
function resolveAfter2Seconds(x) { 
  return new Promise(resolve => {
    setTimeout(() => {
      resolve(x);
    }, 2000);
  });
}

async function f1() {
  var x = await resolveAfter2Seconds(10);
  console.log(x); // 10
}
f1();

</syntaxhighlight>أما إذا لم تكن القيمة كائنًا من النوع <code>[[JavaScript/Promise|Promise]]</code>، فستحوّل عبر الدالة <code>[[JavaScript/Promise/resolve|resolve()‎]]</code>. وسينتظر التعبير <code>await</code> الوعد حتى يتحقق: <syntaxhighlight lang="javascript">
async function f2() {
  var y = await 20;
  console.log(y); // 20
}
f2();

</syntaxhighlight>إذا رُفِضَ الوعد، فسترمى القيمة المرفوضة:<syntaxhighlight lang="javascript">
async function f3() {
  try {
    var z = await Promise.reject(30);
  } catch(e) {
    console.log(e); // 30
  }
}
f3();

</syntaxhighlight>

==دعم المتصفحات==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|55
|52
|غير مدعومة
|42
|10.1
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-async-function-definitions ECMAScript Latest Draft].
* معيار [https://tc39.github.io/ecma262/2017/#sec-async-function-definitions ECMAScript 2017]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Operator|{{SUBPAGENAME}}]]