Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Iterátory a generátory

Iterátor poskytuje postupné výsledky prostřednictvím next(), zatímco iterovatelný objekt dodává iterátor přes Symbol.iterator. Generátor usnadňuje implementaci obou mechanismů pomocí function* a yield.

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

Syntaxe

iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }

Iterátor je objekt s metodou next(), která vrací objekt s výsledkem, nikoli samotný prvek. Iterovatelný objekt zpřístupňuje metodu [Symbol.iterator](), která vrací iterátor. Samotná metoda next() tedy nestačí k tomu, aby šel objekt použít ve for...of.

Výsledek iterátoru — iterator result value/done — popisují pole value a done. Při done: false obsahuje value další prvek. Při done: true je iterace ukončena a value může obsahovat konečnou návratovou hodnotu. Pokud done chybí, považuje se za false; pokud chybí value, výsledkem je undefined. Konec nezjišťujte porovnáním value s undefined: může jít o platný prvek.

Volání funkce function* vytvoří generátor, který je zároveň iterátorem i iterovatelným objektem. next() obnoví vykonávání, yield poskytne prvek a pozastaví funkci a return ji ukončí. for...of a syntaxe rozbalení ... ignorují hodnotu výsledku, pokud je done: true.

Generátor si uchovává stav: jeho opětovné použití iteraci znovu nespustí. Pro nový průchod zavolejte generátorovou funkci znovu. Příklad ukazuje rozdíl mezi prvky z yield a konečnou hodnotou z return.

Příklady

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

Výsledek

10 | false
20 | false
99 | true
undefined | true
10, 20

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje