Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

yield — wstrzymywanie generatora

Wyrażenie `yield` wstrzymuje generator i udostępnia wartość jego odbiorcy. Kolejne `next(value)` wznawia wykonanie i przekazuje wartość do wstrzymanego wyrażenia; `yield*` deleguje iterację.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

yield;
yield expression;
yield* iterable;

yield expression wstrzymuje generator, zachowując jego stan. W generatorze synchronicznym next() zwraca wtedy { value, done: false }. Samo yield udostępnia undefined. Wywołanie funkcji function* tworzy generator; jego ciało zaczyna działać dopiero przy pierwszym next().

Argument kolejnego next(value) staje się wynikiem wstrzymanego wyrażenia yield. Argument pierwszego next() jest ignorowany. Gdy generator kończy działanie przez return value, wynikiem jest { value, done: true }. Jeśli return value powoduje wyjście z bloku try, a w odpowiadającym mu bloku finally wykona się yield, generator może się jeszcze wstrzymać z wynikiem done: false, zanim oczekujący return dobiegnie końca.

yield* iterable deleguje iterację i przekazuje udostępniane wartości; wynikiem tego wyrażenia jest końcowa wartość delegowanego iteratora. Wyrażenia yield są dozwolone w ciałach generatorów synchronicznych i asynchronicznych, lecz nie w ich parametrach ani w zagnieżdżonych zwykłych funkcjach lub funkcjach strzałkowych. W generatorach asynchronicznych next() zwraca obietnicę wyniku iteracji.

Nie umieszczaj końca wiersza między yield a jego argumentem lub *: może to zmienić parsowanie albo spowodować błąd składni. yield nie może być identyfikatorem w kodzie strict ani w kontekstach gramatycznych zarezerwowanych dla generatorów; w niektórych innych kontekstach poza strict jest dozwolone.

Przykłady

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));
}

Wynik

{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła