CKTIS / JavaScript
Protokol iteratora: next(), return(), value i done
Za prepoznavanje kraja iteracije provjeri `done`, a ne `value`. Saznaj kako pročitati završnu vrijednost i kada `for...of` poziva neobaveznu metodu `return()`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const iterator = iterable[Symbol.iterator]();
const result = iterator.next();
// result.done: completion flag; result.value: element or completion value
// When stopping early during manual iteration, call the optional method if callable:
if (typeof iterator.return === "function") {
iterator.return();
}Sinkroni iterator je objekt s metodom next() koja vraća objekt s rezultatom (IteratorResult). Iterabilni objekt ima metodu [Symbol.iterator]() koja vraća iterator. Sama metoda next() ne čini objekt iterabilnim; objekt generatora ima obje uloge. for...of dohvaća iterator i poziva next() bez argumenata. Značenje eventualnog argumenta ovisi o implementaciji iteratora.
Kad je done: false, value je element, čak i ako je njegova vrijednost undefined. done: true označava kraj iteracije; value tada može sadržavati završnu vrijednost koju for...of ne prosljeđuje tijelu petlje. Ako done nedostaje, tretira se kao false; for...of pri provjeri pretvara to svojstvo u logičku vrijednost. Kad se iterator iscrpi, sljedeći pozivi metode next() trebali bi i dalje davati done: true, ali jezik to ne provodi.
Neobavezna metoda return(value) signalizira da pozivatelj prekida iteraciju i omogućuje iteratoru da oslobodi resurse. Rezultat obično sadrži done: true i predani argument kao value, ali generator može vratiti done: false ako izvrši yield u bloku finally. Pri ranom izlasku zbog break ili iznimke u tijelu petlje for...of poziva postojeći return() bez argumenata i zanemaruje done i value rezultata. Ne poziva ga kad se iterator iscrpi uobičajenim putem ili kad sam next() izazove iznimku.
Ručni pozivi metode next() ne zatvaraju iterator automatski. Ako staneš prije kraja, pozovi return() ako ga je moguće pozvati. for...of izaziva TypeError ako next() ili poziv metode return() pri zatvaranju ne vrati objekt. Ako je zatvaranje pokrenula iznimka iz tijela petlje, prednost ima izvorna iznimka.
Primjeri
{
function* sequence() {
try {
yield undefined;
return "end";
} finally {
console.log("cleanup");
}
}
function show(label, { done, value }) {
console.log(`${label}: done=${done}, value=${value}`);
}
const full = sequence();
show("next", full.next());
show("next", full.next());
show("next", full.next());
for (const value of sequence()) {
console.log(`loop: ${value}`);
break;
}
const manual = sequence();
manual.next();
show("return", manual.return("stopped"));
}Rezultat
next: done=false, value=undefined cleanup next: done=true, value=end next: done=true, value=undefined loop: undefined cleanup cleanup return: done=true, value=stopped
Tri odvojena generatora prikazuju uobičajeno iscrpljivanje sa završnom vrijednošću `end`, automatsko zatvaranje zbog `break` i izričit poziv `return("stopped")`. Svaki pokrenuti generator ispisuje `cleanup` u bloku `finally`.
Povezane lekcije
- JavaScript · Lekcija 8 · Napredno · Verzija: 4