CKTIS / JavaScript
yield — pozastavenie generátora
Výraz `yield` pozastaví generátor a sprístupní jeho používateľovi hodnotu. Nasledujúce `next(value)` obnoví vykonávanie a odovzdá hodnotu pozastavenému výrazu; `yield*` deleguje iteráciu.
Verzia: 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 pozastaví generátor a zachová jeho stav. V synchrónnom generátore potom next() vráti { value, done: false }. Samostatné yield sprístupní undefined. Volanie funkcie function* vytvorí generátor; jeho telo sa začne vykonávať až pri prvom next().
Argument nasledujúceho next(value) sa stane výsledkom pozastaveného výrazu yield. Argument prvého next() sa ignoruje. Keď generátor skončí príkazom return value, výsledkom je { value, done: true }. Ak sa pri vykonaní return value opustí blok try a v príslušnom bloku finally sa vykoná yield, generátor sa môže znova pozastaviť s výsledkom done: false, kým sa odložený návrat dokončí.
yield* iterable deleguje iteráciu a odovzdáva vytvorené hodnoty ďalej; výsledkom výrazu je konečná hodnota delegovaného iterátora. Výrazy yield sú povolené v telách synchrónnych aj asynchrónnych generátorov, nie však v ich parametroch ani vo vnorených bežných či šípkových funkciách. V asynchrónnych generátoroch vracia next() promise s výsledkom iterácie.
Nevkladajte zalomenie riadka medzi yield a jeho operand alebo *: môže to zmeniť parsovanie alebo spôsobiť syntaktickú chybu. yield nemôže byť identifikátorom v strict code ani v gramatických kontextoch vyhradených pre generátory; niektoré iné kontexty mimo strict mode ho povoľujú.
Prí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ýsledok
{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.