База знанияИзпитен център
BGБългарски
Избери език13

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}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници