CKTIS / JavaScript
yield — временно спиране на генератор
Изразът `yield` временно спира генератор и предоставя стойност на неговия потребител. Следващото `next(value)` продължава изпълнението и подава стойност на спрения израз; `yield*` делегира итерацията.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
yield;
yield expression;
yield* iterable;yield expression временно спира генератор, като запазва състоянието му. В синхронен генератор next() тогава връща { value, done: false }. Самостоятелният yield предоставя undefined. Извикването на функция function* създава генератор; тялото ѝ започва да се изпълнява едва при първото next().
Аргументът на следващо извикване next(value) става резултатът на спрения израз yield. Аргументът на първото next() се игнорира. Когато генераторът приключи изпълнението си с return value, резултатът е { value, done: true }. Ако return value предизвика излизане от блок try и в съответния блок finally се изпълни yield, генераторът може отново да спре временно с резултат с done: false, преди отложеното връщане да приключи.
yield* iterable делегира итерацията и предава генерираните стойности; резултатът на израза е крайната стойност на делегирания итератор. Изразите yield са разрешени в телата на синхронни и асинхронни генератори, но не и в параметрите им или във вложени обикновени и стрелкови функции. При асинхронните генератори next() връща promise с резултат от итерация.
Не поставяйте нов ред между yield и неговия операнд или *: това може да промени разбора или да причини синтактична грешка. yield не може да бъде идентификатор в strict code или в граматични контексти, запазени за генератори; някои други контексти извън strict mode го позволяват.
Примери
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));
}Резултат
{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.