Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Generator.prototype.next() — wznawianie generatora

Metoda `next()` uruchamia lub wznawia generator synchroniczny i zwraca obiekt wyniku iteracji. Opcjonalny argument staje się wynikiem wstrzymanego wyrażenia ze zwykłym `yield`; argument pierwszego wywołania jest ignorowany.

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

generator.next()
generator.next(value)

Generator.prototype.next to metoda używana jako generator.next(). Wywołanie funkcji function* tworzy generator, ale nie wykonuje jego ciała. Pierwsze next() rozpoczyna wykonanie, a kolejne wznawiają je do następnego wstrzymania lub zakończenia.

Przy zwykłym yield wynik zawiera udostępnioną wartość w polu value oraz done: false. Gdy generator kończy się bez wyjątku, wynik zawiera done: true, a w polu value jest wartość z return albo undefined, jeśli nie podano wartości. Dalsze wywołania po zakończeniu zwracają { value: undefined, done: true }.

Podczas delegowania przez yield*, jeśli done w wyniku zwróconym przez next() delegowanego iteratora jest fałszywe po konwersji na wartość logiczną, next() zewnętrznego generatora zwraca ten sam obiekt bez zmian. Na przykład jeśli delegowany iterator zwróci {}, brak done jest traktowany jak false, a zwrócony obiekt nadal nie ma ani value, ani done.

Gdy generator jest wstrzymany na zwykłym yield, argument next(value) staje się wynikiem tego wyrażenia. W const input = yield "ready" pierwszy krok udostępnia "ready", a następny next(7) przypisuje 7 do input. Argument pierwszego wywołania jest ignorowany, bo generator nie jest jeszcze wstrzymany na yield.

Ponowne wejście przez next() do generatora, który właśnie się wykonuje, powoduje TypeError. Każda instancja przechodzi swoją sekwencję tylko raz; aby zacząć od nowa, wywołaj ponownie funkcję generatora.

Przykłady

function* exchange() {
  const input = yield "ready";
  return input * 2;
}

const generator = exchange();

function print(result) {
  console.log(String(result.value) + " | " + result.done);
}

print(generator.next(999));
print(generator.next(7));
print(generator.next());

Wynik

ready | false
14 | true
undefined | true

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

Źródła