CKTIS / JavaScript
yield — een generator onderbreken
De expressie `yield` onderbreekt een generator en geeft een waarde aan de afnemer. Een volgende `next(value)` hervat de uitvoering en geeft een waarde aan de onderbroken expressie; `yield*` delegeert de iteratie.
Versie: 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 onderbreekt een generator met behoud van de toestand. In een synchrone generator geeft next() dan { value, done: false } terug. Een yield zonder operand geeft undefined. Een aanroep van een function*-functie maakt een generator; de body wordt pas uitgevoerd bij de eerste next().
Het argument van een volgende next(value) wordt het resultaat van de onderbroken yield-expressie. Het argument van de eerste next() wordt genegeerd. Wanneer de generator eindigt met return value, is het resultaat { value, done: true }. Als de uitvoering door return value een try-blok verlaat en in het bijbehorende finally-blok een yield uitvoert, kan de generator opnieuw worden onderbroken met een resultaat met done: false voordat de uitgestelde return is voltooid.
yield* iterable delegeert de iteratie en geeft de voortgebrachte waarden door; het resultaat van de expressie is de eindwaarde van de gedelegeerde iterator. yield-expressies zijn toegestaan in bodies van synchrone en asynchrone generators, maar niet in hun parameters of in geneste gewone functies of arrowfuncties. In asynchrone generators geeft next() een promise voor een iteratieresultaat terug.
Plaats geen regeleinde tussen yield en de operand of *: dit kan de parsing veranderen of een syntaxfout veroorzaken. yield kan geen identifier zijn in strict code of in grammaticale contexten die voor generators zijn gereserveerd; in sommige andere niet-strikte contexten is het toegestaan.
Voorbeelden
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));
}Resultaat
{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.