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.