عرض مصدر TypeScript/iterators and generators

<noinclude>{{DISPLAYTITLE:المكررات والمولدات في TypeScript}}</noinclude>

==الكائنات القابلة للتكرار (Iterables)==
يُعدّ كائنٌ قابلًا للتكرار إذا كان يطبِّق الخاصيّة ‎[[JavaScript/Symbol/iterator|<code>Symbol.iterator</code>‎]]. هناك بعض الأنواع القابلة للتكرار المضمّنة في اللغة مثل ‎<code>Array</code>‎، و‎<code>Map</code>‎، و‎<code>Set</code>‎، و‎<code>String</code>‎، و‎<code>Int32Array</code>‎، و‎<code>Uint32Array</code>‎، إلخ… تُطبِّق هذه الأنواع الخاصية ‎<code>Symbol.iterator</code>‎ داخليًّا. تكون الدالةُ ‎<code>Symbol.iterator</code>‎ على كائنٍ معيّنٍ الدالةَ المسؤولةَ عن إعادة قائمة القيم التي يُكرَّر عليها.

===جمل ‎<code>[[JavaScript/for...of|for..of]]</code>‎===
تدور الجملة ‎ <code>[[JavaScript/for...of|for..of]]</code>‎‎حول كائن قابل للتكرار مُستدعيَةً الخاصيّة ‎<code>Symbol.iterator</code>‎ الموجودة على الكائن. هذا مثال بسيط على كيفيّة استخدام ‎<code>for..of</code>‎ للدوران على عناصر مصفوفة:
<syntaxhighlight lang="typescript">
let someArray = [1, "string", false];

for (let entry of someArray) {
    console.log(entry); // 1, "string", false
}
</syntaxhighlight>
===جمل ‎<code>for..of</code>‎ مقابلَ جملِ ‎<code>[[JavaScript/for...in|for..in]]</code>‎===
تُكرِّر كل من الجملتين ‎<code>for..of</code>‎ و‎<code>for..in</code>‎ على القوائم؛ لكن القيم المكرَّر عليها مختلفة، إذ تُعيد ‎<code>for..in</code>‎ قائمةَ مفاتيحِ الكائن المُكرَّر عليه، أمّا ‎<code>for..of</code>‎ فتُعيد قائمة قيمِ الخاصيات العدديّة الخاصة بالكائن المُكرَّر عليه.

يُوضّح هذا المثال الفرق:
<syntaxhighlight lang="typescript">
let list = [4, 5, 6];

for (let i in list) {
   console.log(i); // "0", "1", "2",
}

for (let i of list) {
   console.log(i); // "4", "5", "6"
}
</syntaxhighlight>
ومن الاختلافات كذلك أنّ الجملة ‎<code>for..in</code>‎ تعمل على أي كائن، وتعمل كطريقة لاستكشاف خاصيات الكائن. أمّا ‎<code>for..of</code>‎ فتُستعمَل فقط للوصول إلى قيم الكائنات القابلة للتكرار. تطبّق الكائنات المضمّنة مثل ‎<code>Map</code>‎ و‎<code>Set</code>‎ الخاصيّةَ ‎<code>Symbol.iterator</code>‎، ما يسمح بالوصول إلى القيم المُخزَّنة:
<syntaxhighlight lang="typescript">
let pets = new Set(["Cat", "Dog", "Hamster"]);
pets["species"] = "mammals";

for (let pet in pets) {
   console.log(pet); // "species"
}

for (let pet of pets) {
    console.log(pet); // "Cat", "Dog", "Hamster"
}
</syntaxhighlight>
===توليد الشيفرة===
====استهداف النسختين ES5 وES3====
عند استهداف النسخة ES5 أو النسخة ES3، فيُسمح للمُكرِّرات (iterators) على قيم النوع ‎<code>Array</code>‎ فقط. وسيُطلَق خطأ إن استُعملت حلقات ‎<code>for..of</code>‎ على قيمٍ أخرى غير المصفوفات، حتى ولو طبّقت هذه القيم الخاصيّة ‎<code>Symbol.iterator</code>‎.

سيُولِّد المترجم حلقة ‎<code>for</code>‎ بسيطة لحلقات ‎<code>for..of</code>‎، مثلًا الشيفرةُ:

<syntaxhighlight lang="typescript">
let numbers = [1, 2, 3];
for (let num of numbers) {
    console.log(num);
}
</syntaxhighlight>
تولّد الشيفرةَ:
<syntaxhighlight lang="typescript">
var numbers = [1, 2, 3];
for (var _i = 0; _i < numbers.length; _i++) {
    var num = numbers[_i];
    console.log(num);
}
</syntaxhighlight>
====استهداف النسخة ECMAScript 2015 وما بعدها====
عند استهداف محرّكٍ (engine) متوافق مع  ECMAScipt 2015، فسيولّد المترجم حلقات ‎<code>_</code>‎ لاستهداف تطبيق المكرّرات المضمَّن في المحرّك.

== مصادر ==
* [https://www.typescriptlang.org/docs/handbook/iterators-and-generators.html صفحة Iterators and Generators في توثيق TypeScript الرسمي.]
[[تصنيف:TypeScript]]