WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Iteratoren und Generatoren

Ein Iterator stellt über next() aufeinanderfolgende Ergebnisse bereit, während ein iterierbares Objekt über Symbol.iterator einen Iterator liefert. Mit function* und yield lassen sich beide Mechanismen einfacher umsetzen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }

Ein Iterator ist ein Objekt mit einer next()-Methode, die ein Ergebnisobjekt zurückgibt, nicht das Element selbst. Ein iterierbares Objekt stellt eine [Symbol.iterator]()-Methode bereit, die einen Iterator zurückgibt. Nur next() zu besitzen, reicht daher nicht aus, um ein Objekt in for...of zu verwenden.

Das Iteratorergebnis — iterator result value/done — wird durch die Felder value und done beschrieben. Bei done: false enthält value das nächste Element. Bei done: true ist die Iteration beendet, und value kann einen abschließenden Rückgabewert enthalten. Fehlt done, wird es als false behandelt; fehlt value, ergibt sich undefined. Erkennen Sie das Ende nicht durch einen Vergleich von value mit undefined: Das kann ein gültiges Element sein.

Der Aufruf einer function*-Funktion erzeugt einen Generator, der zugleich Iterator und iterierbares Objekt ist. next() setzt die Ausführung fort, yield liefert ein Element und hält die Funktion an, und return beendet sie. for...of und die Spread-Syntax ... ignorieren den Wert des Ergebnisses mit done: true.

Ein Generator behält seinen Zustand bei: Seine Wiederverwendung startet die Iteration nicht neu. Rufen Sie die Generatorfunktion erneut auf, um einen neuen Durchlauf zu beginnen. Das Beispiel zeigt den Unterschied zwischen Elementen aus yield und dem abschließenden Wert aus return.

Beispiele

function* numbers() {
  yield 10;
  yield 20;
  return 99;
}

const iterator = numbers();
for (let i = 0; i < 4; i++) {
  const { value, done } = iterator.next();
  console.log(`${String(value)} | ${done}`);
}
console.log([...numbers()].join(", "));

Ergebnis

10 | false
20 | false
99 | true
undefined | true
10, 20

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen