CKTIS / JavaScript
Generator.prototype.next() — obnovenie generátora
Metóda `next()` spustí alebo obnoví synchrónny generátor a vráti objekt s výsledkom iterácie. Jej voliteľný argument sa stane výsledkom pozastaveného výrazu s obyčajným `yield`; argument prvého volania sa ignoruje.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
generator.next()
generator.next(value)Generator.prototype.next je metóda používaná ako generator.next(). Volanie funkcie function* vytvorí generátor, ale nevykoná jeho telo. Prvé next() spustí vykonávanie; ďalšie volania v ňom pokračujú až do ďalšieho pozastavenia alebo skončenia.
Pri obyčajnom yield je sprístupnená hodnota vo vlastnosti value a výsledok má done: false. Keď sa generátor skončí bez výnimky, výsledok má done: true a vo vlastnosti value je hodnota z return, prípadne undefined, ak nebola zadaná žiadna hodnota. Ďalšie volania po skončení vrátia { value: undefined, done: true }.
Pri delegovaní pomocou yield* sa vlastnosť done z výsledku volania next() delegovaného iterátora prevádza na logickú hodnotu. Ak je touto hodnotou false, metóda next() vonkajšieho generátora vráti ten istý objekt bez zmeny. Ak delegovaný iterátor vráti napríklad {}, chýbajúca vlastnosť done sa vyhodnotí ako false a vrátený objekt naďalej nemá ani value, ani done.
Keď je generátor pozastavený pri obyčajnom yield, argument next(value) sa stane výsledkom tohto výrazu. V const input = yield "ready" prvý krok sprístupní "ready" a nasledujúce next(7) priradí hodnotu 7 do input. Argument prvého volania sa ignoruje, pretože generátor ešte nie je pozastavený pri yield.
Opätovný vstup do práve vykonávaného generátora pomocou next() vyvolá TypeError. Každá inštancia prejde svoju sekvenciu iba raz; ak chceš začať odznova, znova zavolaj funkciu generátora.
Prí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ýsledok
ready | false 14 | true undefined | true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.