CKTIS / JavaScript
yield — einen Generator anhalten
Der Ausdruck `yield` hält einen Generator an und gibt seinem Verbraucher einen Wert. Ein anschließendes `next(value)` setzt die Ausführung fort und übergibt einen Wert an den angehaltenen Ausdruck; `yield*` delegiert die Iteration.
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
yield;
yield expression;
yield* iterable;yield expression hält einen Generator an und bewahrt dabei seinen Zustand. In einem synchronen Generator gibt next() dann { value, done: false } zurück. Ein alleinstehendes yield gibt undefined aus. Der Aufruf einer function*-Funktion erzeugt einen Generator; sein Funktionsrumpf wird erst beim ersten next() ausgeführt.
Das Argument eines nachfolgenden next(value) wird zum Ergebnis des angehaltenen yield-Ausdrucks. Das Argument des ersten next() wird ignoriert. Wenn der Generator mit return value endet, lautet das Ergebnis { value, done: true }. Wird durch return value ein try-Block verlassen und im zugehörigen finally-Block ein yield ausgeführt, kann der Generator erneut anhalten und ein Ergebnis mit done: false liefern, bevor die ausstehende Rückgabe abgeschlossen ist.
yield* iterable delegiert die Iteration und reicht die ausgegebenen Werte weiter; das Ergebnis des Ausdrucks ist der abschließende Wert des delegierten Iterators. yield-Ausdrücke sind in synchronen und asynchronen Generatorrümpfen erlaubt, nicht aber in ihren Parametern oder in verschachtelten gewöhnlichen Funktionen oder Pfeilfunktionen. In asynchronen Generatoren gibt next() ein Promise für ein Iterationsergebnis zurück.
Setze keinen Zeilenumbruch zwischen yield und seinem Operanden oder *: Das kann die Analyse des Codes ändern oder einen Syntaxfehler verursachen. yield kann in strict code oder in für Generatoren reservierten Grammatik-Kontexten kein Bezeichner sein; in einigen anderen Kontexten ohne strict mode ist es zulässig.
Beispiele
function* exchange() {
const received = yield 10;
yield received + 1;
return 99;
}
const iterator = exchange();
for (const result of [iterator.next(), iterator.next(20), iterator.next()]) {
console.log(JSON.stringify(result));
}Ergebnis
{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":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.