WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Generator.prototype.next() — einen Generator fortsetzen

Die Methode `next()` startet einen synchronen Generator oder setzt ihn fort und gibt ein Iterationsergebnisobjekt zurück. Bei einem einfachen `yield` wird ihr optionales Argument zum Ergebnis des angehaltenen Ausdrucks; das Argument des ersten Aufrufs wird ignoriert.

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

generator.next()
generator.next(value)

Generator.prototype.next ist die Methode, die als generator.next() verwendet wird. Der Aufruf einer function*-Funktion erstellt einen Generator, führt seinen Funktionskörper aber nicht aus. Das erste next() startet die Ausführung; spätere Aufrufe setzen sie fort, bis der Generator erneut anhält oder endet.

Bei einem einfachen yield enthält das Ergebnis den ausgegebenen Wert in value und hat done: false. Endet der Generator ohne Ausnahme, enthält das Ergebnis done: true und in value den Wert von return oder undefined, wenn kein Wert angegeben wurde. Weitere Aufrufe nach dem Abschluss geben { value: undefined, done: true } zurück.

Bei der Delegation mit yield* prüft der äußere Generator done im Ergebnis von next() des delegierten Iterators. Ergibt die Umwandlung in einen booleschen Wert false, gibt das äußere next() dasselbe Objekt unverändert zurück. Gibt der delegierte Iterator beispielsweise {} zurück, wird das fehlende done als false behandelt. Das zurückgegebene Objekt enthält weiterhin weder value noch done.

Ist der Generator bei einem einfachen yield angehalten, wird das Argument von next(value) zum Ergebnis dieses Ausdrucks. In const input = yield "ready" gibt der erste Schritt "ready" zurück, und das darauffolgende next(7) weist input den Wert 7 zu. Das Argument des ersten Aufrufs wird ignoriert, weil der Generator noch nicht bei einem yield angehalten ist.

Ein erneuter Aufruf von next() auf einem gerade laufenden Generator löst einen TypeError aus. Jede Instanz durchläuft ihre Sequenz nur einmal; rufe die Generatorfunktion erneut auf, um von vorn zu beginnen.

Beispiele

function* exchange() {
  const input = yield "ready";
  return input * 2;
}

const generator = exchange();

function print(result) {
  console.log(String(result.value) + " | " + result.done);
}

print(generator.next(999));
print(generator.next(7));
print(generator.next());

Ergebnis

ready | false
14 | true
undefined | true

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