Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Generator.prototype.next() — nadaljevanje generatorja

Metoda `next()` zažene ali nadaljuje izvajanje sinhronega generatorja in vrne objekt z rezultatom iteracije. Njen neobvezni argument postane rezultat začasno ustavljenega izraza z navadnim `yield`; argument prvega klica se prezre.

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

Sintaksa

generator.next()
generator.next(value)

Generator.prototype.next je metoda, ki se uporablja kot generator.next(). Klic funkcije function* ustvari generator, vendar ne izvede njegovega telesa. Prvi next() začne izvajanje; nadaljnji klici ga nadaljujejo do naslednje začasne ustavitve ali do konca.

Pri navadnem yield je posredovana vrednost v lastnosti value, rezultat pa ima done: false. Ko se izvajanje generatorja konča brez izjeme, rezultat vsebuje done: true, v lastnosti value pa je vrednost iz return ali undefined, če vrednost ni bila podana. Nadaljnji klici po koncu vrnejo { value: undefined, done: true }.

Pri delegiranju z yield* se lastnost done v rezultatu, ki ga vrne next() delegiranega iteratorja, pretvori v logično vrednost. Če je ta vrednost false, next() zunanjega generatorja vrne isti objekt brez sprememb. Če delegirani iterator na primer vrne {}, se manjkajoča lastnost done obravnava kot false, vrnjeni objekt pa še vedno nima ne value ne done.

Ko je generator začasno ustavljen pri navadnem yield, argument metode next(value) postane rezultat tega izraza. V const input = yield "ready" prvi korak posreduje "ready", naslednji klic next(7) pa dodeli 7 spremenljivki input. Argument prvega klica se prezre, ker generator še ni ustavljen pri yield.

Ponovni vstop v generator, ki se trenutno izvaja, z metodo next() povzroči TypeError. Vsak primerek preide svoje zaporedje samo enkrat; za nov začetek znova pokliči generatorsko funkcijo.

Primeri

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

Rezultat

ready | false
14 | true
undefined | true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri