CKTIS / JavaScript
Iteratorji in generatorji
Iterator zaporedne rezultate ponuja prek next(), iterabilni objekt pa iterator zagotovi prek Symbol.iterator. Generator olajša izvedbo obeh mehanizmov z uporabo function* in yield.
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
iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }Iterator je objekt z metodo next(), ki vrne objekt z rezultatom, ne pa samega elementa. Iterabilni objekt izpostavi metodo [Symbol.iterator](), ki vrne iterator. Samo metoda next() zato še ne zadošča za uporabo objekta v for...of.
Rezultat iteratorja — iterator result value/done — opisujeta polji value in done. Pri done: false polje value vsebuje naslednji element. Pri done: true je iteracija končana, value pa lahko vsebuje končno vrnjeno vrednost. Če done manjka, se obravnava kot false; če manjka value, je rezultat undefined. Konca ne ugotavljajte s primerjavo value z undefined: to je lahko veljaven element.
Klic funkcije function* ustvari generator, ki je hkrati iterator in iterabilni objekt. next() nadaljuje izvajanje, yield poda element in začasno ustavi funkcijo, return pa jo konča. for...of in sintaksa razširjanja ... prezreta vrednost rezultata, kadar je done: true.
Generator ohranja svoje stanje: ponovna uporaba ne začne iteracije znova. Za nov prehod znova pokličite generatorsko funkcijo. Primer prikazuje razliko med elementi iz yield in končno vrednostjo iz return.
Primeri
function* numbers() {
yield 10;
yield 20;
return 99;
}
const iterator = numbers();
for (let i = 0; i < 4; i++) {
const { value, done } = iterator.next();
console.log(`${String(value)} | ${done}`);
}
console.log([...numbers()].join(", "));Rezultat
10 | false 20 | false 99 | true undefined | true 10, 20
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.