عرض مصدر JavaScript/yield*

<noinclude>{{DISPLAYTITLE:<code>yield*‎</code> في JavaScript}}</noinclude>
التعبير <code>yield*‎</code> يُستخدَم لتفويض التنفيذ إلى [[JavaScript/function*|دالة مولِّدة]] أخرى أو كائن iterable.
==البنية العامة==
<syntaxhighlight lang="javascript">
 yield* [[expression]];

</syntaxhighlight>
=== <code>expression</code> ===
التعبير الذي سيُعيد كائن iterable.

== الوصف ==
سيؤدي التعبير <code>yield*‎</code> إلى المرور على عناصر الكائن ويعطي كل قيمة أعادها هذا الكائن.

قيمة التعبير <code>yield*‎</code> نفسه هي القيمة المُعادة من الكائن iterable عند إغلاقه (أي عندما تكون قيمة الخاصية <code>done</code> هي <code>true</code>). 

== أمثلة ==

=== تفويض التنفيذ إلى دالة مولِّدة أخرى ===
لاحظ أنَّ القيمة التي تعطيها (yield) الدالة <code>g1()</code>‎ ستُعاد عند استدعاء الدالة <code>next()‎</code> مثل القيم التي تعطيها الدالة <code>g2()‎</code>:<syntaxhighlight lang="javascript">
function* g1() {
  yield 2;
  yield 3;
  yield 4;
}

function* g2() {
  yield 1;
  yield* g1();
  yield 5;
}

var iterator = g2();

console.log(iterator.next()); // {value: 1, done: false}
console.log(iterator.next()); // {value: 2, done: false}
console.log(iterator.next()); // {value: 3, done: false}
console.log(iterator.next()); // {value: 4, done: false}
console.log(iterator.next()); // {value: 5, done: false}
console.log(iterator.next()); // {value: undefined, done: true}
</syntaxhighlight>

=== كائنات itreable الأخرى ===
يمكن استخدام التعبير <code>yield*‎</code> لإعطاء قيمة لكائنات iterable، مثل المصفوفات والسلاسل النصية وكائن <code>[[JavaScript/arguments|arguments]]</code> (الوسائط المُمرَّرة إلى الدالة):<syntaxhighlight lang="javascript">
function* g3() {
  yield* [1, 2];
  yield* '34';
  yield* Array.from(arguments);
}

var iterator = g3(5, 6);

console.log(iterator.next()); // {value: 1, done: false}
console.log(iterator.next()); // {value: 2, done: false}
console.log(iterator.next()); // {value: "3", done: false}
console.log(iterator.next()); // {value: "4", done: false}
console.log(iterator.next()); // {value: 5, done: false}
console.log(iterator.next()); // {value: 6, done: false}
console.log(iterator.next()); // {value: undefined, done: true}

</syntaxhighlight>

=== قيمة التعبير <code>yield*‎</code> نفسه ===
لاحظ أنَّ <code>yield*‎</code> هو تعبير (expression) وليس تعبير برمجي (statement)، لذا ستكون له قيمة:<syntaxhighlight lang="javascript">
function* g4() {
  yield* [1, 2, 3];
  return 'foo';
}

var result;

function* g5() {
  result = yield* g4();
}

var iterator = g5();

console.log(iterator.next()); // {value: 1, done: false}
console.log(iterator.next()); // {value: 2, done: false}
console.log(iterator.next()); // {value: 3, done: false}
console.log(iterator.next()); // {value: undefined, done: true}, 

// g4() returned {value: 'foo', done: true} 
console.log(result); // "foo"

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|غير مدعومة
|نعم
|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}}]]