Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori