المولّدات والمكرّرات (Generators & Iterators)

const letters = ["أ", "ب", "ج"];
for (const letter of letters) {
  console.log(letter);
}
// خلف الكواليس: for...of تستدعي letters[Symbol.iterator]() وتستخدم .next()

function makeRangeIterator(start, end) {
  let current = start;
  return {
    next() {
      if (current < end) {
        return { value: current++, done: false };
      }
      return { value: undefined, done: true };
    },
  };
}

const it = makeRangeIterator(1, 4);
console.log(it.next()); // { value: 1, done: false }
console.log(it.next()); // { value: 2, done: false }
console.log(it.next()); // { value: 3, done: false }
console.log(it.next()); // { value: undefined, done: true }

function* range(start, end) {
  for (let i = start; i < end; i++) {
    yield i;
  }
}

for (const n of range(1, 4)) {
  console.log(n); // 1 2 3
}

// أو يدويًا:
const gen = range(1, 4);
console.log(gen.next()); // { value: 1, done: false }
console.log(gen.next()); // { value: 2, done: false }

function* naturalNumbers() {
  let n = 1;
  while (true) yield n++;
}

const numbers = naturalNumbers();
console.log(numbers.next().value); // 1
console.log(numbers.next().value); // 2
console.log(numbers.next().value); // 3
// لا تنتهي أبدًا، لكن تُنتج قيمة واحدة فقط بكل استدعاء — كفاءة ذاكرة

class Playlist {
  constructor(songs) {
    this.songs = songs;
  }
  *[Symbol.iterator]() {
    for (const song of this.songs) yield song;
  }
}

const playlist = new Playlist(["أغنية 1", "أغنية 2"]);
for (const song of playlist) {
  console.log(song); // يعمل مباشرة بفضل *[Symbol.iterator]
}