CKTIS / JavaScript
yield — pozastavení generátoru
Výraz `yield` pozastaví generátor a zpřístupní jeho uživateli hodnotu. Následující `next(value)` obnoví vykonávání a předá hodnotu pozastavenému výrazu; `yield*` deleguje iteraci.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
yield;
yield expression;
yield* iterable;yield expression pozastaví generátor a zachová jeho stav. V synchronním generátoru pak next() vrátí { value, done: false }. Samostatné yield zpřístupní undefined. Volání funkce function* vytvoří generátor; jeho tělo se začne vykonávat až při prvním next().
Argument následujícího next(value) se stane výsledkem pozastaveného výrazu yield. Argument prvního next() se ignoruje. Když generátor skončí příkazem return value, výsledkem je { value, done: true }. Pokud se kvůli return value opustí blok try a v příslušném bloku finally se vykoná yield, generátor se může znovu pozastavit s výsledkem done: false, než se odložený návrat dokončí.
yield* iterable deleguje iteraci a předává vygenerované hodnoty dál; výsledkem výrazu je konečná hodnota delegovaného iterátoru. Výrazy yield jsou povoleny v tělech synchronních i asynchronních generátorů, nikoli však v jejich parametrech nebo ve vnořených běžných funkcích či šipkových funkcích. V asynchronních generátorech vrací next() promise s výsledkem iterace.
Nevkládejte konec řádku mezi yield a jeho operand nebo *: může to změnit parsování nebo způsobit syntaktickou chybu. yield nemůže být identifikátorem v strict code ani v gramatických kontextech vyhrazených pro generátory; některé jiné kontexty mimo strict mode jej povolují.
Příklady
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));
}Výsledek
{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.