CKTIS / JavaScript
Generatorska funkcija: function*
Generatorska funkcija stvara iterator čije se izvođenje može pauzirati na yield i nastaviti pomoću next(). Vrijednosti računa prema potrebi i čuva lokalno stanje između uzastopnih koraka.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
function* name(parameters) {
yield value;
return finalValue;
}Deklaracija function* name(parameters) { ... } definira generatorsku funkciju. Poziv stvara novi objekt Generator, ali još ne izvršava tijelo funkcije. Svaki objekt ima vlastito stanje izvođenja; prvi next() pokreće tijelo, a yield value predaje vrijednost i pauzira izvođenje.
Sljedeći next() nastavlja izvođenje nakon yield i čuva lokalne varijable. Rezultat ima polja value i done: yield daje done: false, dok return finalValue završava generator s done: true. Bez izričitog return konačna je vrijednost undefined. Nakon završetka, daljnji pozivi next() vraćaju value: undefined i done: true.
Objekt generatora istodobno je iterator i iterabilni objekt. for...of i sintaksa spread (...) u literalima polja i na popisima argumenata pri pozivu funkcije obrađuju vrijednosti iz yield, ali izostavljaju konačnu vrijednost iz return. U objektnim literalima sintaksa spread ne nastavlja izvođenje generatora, nego kopira njegova vlastita nabrojiva svojstva. Iscrpljeni generator ne može se ponovno pokrenuti; umjesto toga ponovno pozovite funkciju. Argument za next(value) postaje rezultat pauziranog izraza yield; argument prvog next() zanemaruje se.
Generator možete definirati i izrazom kao što je const make = function* () { yield 1; };, pri čemu je ime funkcije neobavezno. Ne postoji sintaksa generatorske funkcije strelice. MDN klasificira function* kao široko dostupan u preglednicima od rujna 2016.; podršku ciljanog preglednika provjerite zasebno.
Primjeri
function* steps() {
yield 10;
yield 20;
return 30;
}
const iterator = steps();
for (let i = 0; i < 4; i++) {
const { value, done } = iterator.next();
console.log(`${value} | ${done}`);
}
console.log([...steps()].join(", "));Rezultat
10 | false 20 | false 30 | true undefined | true 10, 20
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.