Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Generator.prototype.next() — obnovení generátoru

Metoda `next()` spustí nebo obnoví synchronní generátor a vrátí objekt s výsledkem iterace. Její volitelný argument se stane výsledkem pozastaveného výrazu s obyčejným `yield`; argument prvního volání se ignoruje.

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

Syntaxe

generator.next()
generator.next(value)

Generator.prototype.next je metoda používaná jako generator.next(). Volání funkce function* vytvoří generátor, ale nespustí jeho tělo. První next() zahájí vykonávání; další volání v něm pokračují do dalšího pozastavení nebo do konce.

U obyčejného yield obsahuje výsledek poskytnutou hodnotu ve vlastnosti value a má done: false. Pokud generátor skončí bez výjimky, výsledek má done: true a ve vlastnosti value je hodnota z return, případně undefined, pokud žádná hodnota uvedena nebyla. Další volání po dokončení vracejí { value: undefined, done: true }.

Při delegování pomocí yield* se vlastnost done z výsledku volání next() delegovaného iterátoru převádí na logickou hodnotu. Pokud je touto hodnotou false, metoda next() vnějšího generátoru vrátí tentýž objekt beze změny. Vrátí-li delegovaný iterátor například {}, chybějící done se vyhodnotí jako false a vrácený objekt stále nemá ani value, ani done.

Je-li generátor pozastavený u obyčejného yield, argument next(value) se stane výsledkem tohoto výrazu. V const input = yield "ready" zpřístupní první krok "ready" a následující next(7) přiřadí hodnotu 7 do input. Argument prvního volání se ignoruje, protože generátor ještě není pozastavený u yield.

Opětovný vstup do právě vykonávaného generátoru pomocí next() vyvolá TypeError. Každá instance projde svou sekvencí pouze jednou; pro nový začátek znovu zavolej funkci generátoru.

Příklady

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

Výsledek

ready | false
14 | true
undefined | true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje