Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje