عرض مصدر JavaScript/yield

<noinclude>{{DISPLAYTITLE:<code>yield</code> في JavaScript}}</noinclude>
الكلمة المحجوزة <code>yield</code> تُستخدَم لإيقاف تنفيذ دالة مولِّدة (<code>[[JavaScript/function*|function*‎]]</code>) مؤقتًا واستئناف تنفيذها.
==البنية العامة==
<syntaxhighlight lang="javascript">
[rv] = yield [expression];

</syntaxhighlight>
=== <code>expression</code> ===
تعريف القيمة التي ستُعاد من الدالة الموِّلدة عبر بروتوكول [[JavaScript/Iteration Protocols|iterator]]، وإذا لم تُحدَّد هذه القيمة فستُعاد القيمة <code>[[JavaScript/undefined|undefined]]</code>.

=== <code>rv</code> ===
إسناد القيمة الاختيارية المُمرَّرة إلى الدالة <code>next()‎</code> التي تُستخدَم لاستئناف التنفيذ.

== الوصف ==
الكلمة المحجوزة <code>yield</code> توقف تنفيذ دالة مولِّدة مؤقتًا وستُعاد قيمة التعبير الذي يلي الكلمة المحجوزة <code>yield</code> إلى التعبير البرمجي الذي استدعى الدالة المولِّدة؛ ويمكن عدّ الكلمة المحجوزة <code>yield</code> على أنها تشبه <code>[[JavaScript/return|return]]</code> لكن للدوال المولِّدة.

تُعيد الكلمة المحجوزة <code>yield</code> كائنًا من النوع <code>IteratorResult</code> له خاصيتان هما <code>value</code> و <code>done</code>، والخاصية <code>value</code> ستحتوي على نتيجة التعبير الذي يلي الكلمة المحجوزة <code>yield</code>، وستكون قيمة الخاصية <code>done</code> مساويةً للقيمة <code>false</code> مما يشير إلى أنَّ تنفيذ الدالة المولِّدة لم ينتهِ بعد.

بعد إيقاف تنفيذ الدالة المولِّدة مؤقتًا عند ورود التعبير <code>yield</code> فسيبقى تنفيذ الدالة متوقفًا إلى أن تستدعى الدالة <code>next()‎</code> على الدالة المولِّدة، وستستئنف حينئذٍ الدالةُ تنفيذها إلى أن تصل إلى:
* تعبير <code>yield</code> آخر، الذي يؤدي إلى إيقاف الدالة المولِّدة موقتًا مجددًا ويُعيد قيمةً جديدةً، وفي المرة القادمة التي ستستدعى فيها  الدالة <code>next()‎</code> سيُستأنف التنفيذ بعد تعبير <code>yield</code> الجديد.
* رمي استثناء من الدالة المولِّدة عبر <code>[[JavaScript/throw|throw]]</code>، وهذا سيوقف تنفيذ الدالة المولِّدة كليًّا، وسيستمر التنفيذ في البنية البرمجية التي استدعت الدالة المولِّدة.
* الوصول إلى نهاية الدالة المولِّدة، وفي هذه الحالة سينتهي تنفيذ الدالة المولِّدة وسيُعاد كائن <code>IteratorResult</code> الذي تكون قيمة الخاصية <code>value</code> فيه هي <code>[[JavaScript/undefined|undefined]]</code> والخاصية <code>done</code> هي <code>true</code>.
* تنفيذ التعبير البرمجي <code>[[JavaScript/return|return]]</code>، وفي هذه الحالة سيتوقف تنفيذ الدالة المولِّدة وسيُعاد الكائن <code>IteratorResult</code> وستكون قيمة الخاصية <code>value</code> فيه هي القيمة المُحدَّدة بعد تعبير <code>[[JavaScript/return|return]]</code> وقيمة الخاصية <code>done</code> هي <code>true</code>.
إذا مُرِّرَت قيمةٌ اختياريةٌ إلى الدالة <code>[[JavaScript/Generator/next|Generator.prototype.next()]]‎</code> فستصبح هذه القيمة هي القيمة المُعادة من تعبير <code>yield</code> الحالي في الدالة المولِّدة (أي قيمة <code>rv</code>، انظر «<nowiki/>[[#البنية العامة|البنية العامة]]»). 

== أمثلة ==
الشيفرة الآتية تُصرِّح عن دالة مولِّدة بسيطة:<syntaxhighlight lang="javascript">
function* countAppleSales () {
  var saleList = [3, 7, 5];
  for (var i = 0; i < saleList.length; i++) {
    yield saleList[i];
  }
}
</syntaxhighlight>بعد تعريف الدالة المولِّدة، يمكن استخدامها كما في المثال الآتي:<syntaxhighlight lang="javascript">
var appleStore = countAppleSales(); // Generator { }
console.log(appleStore.next()); // { value: 3, done: false }
console.log(appleStore.next()); // { value: 7, done: false }
console.log(appleStore.next()); // { value: 5, done: false }
console.log(appleStore.next()); // { value: undefined, done: true }

</syntaxhighlight>

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

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/# ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/# ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Operator|{{SUBPAGENAME}}]]