Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Iteratory i generatory

Iterator udostępnia kolejne wyniki przez next(), a obiekt iterowalny dostarcza iterator przez Symbol.iterator. Generator ułatwia tworzenie obu tych mechanizmów za pomocą function* i yield.

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

Składnia

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

Iterator to obiekt z metodą next(), która zwraca obiekt wyniku, nie sam element. Obiekt iterowalny udostępnia metodę [Symbol.iterator](), zwracającą iterator. Samo posiadanie next() nie wystarcza więc do użycia obiektu w for...of.

Wynik iteratora — iterator result value/done — opisują pola value i done. Przy done: false pole value zawiera kolejny element. Przy done: true iteracja jest zakończona, a value może zawierać wartość końcową. Brak done jest traktowany jak false; brak value daje undefined. Nie wykrywaj końca przez porównanie value z undefined: taka wartość może być poprawnym elementem.

Wywołanie funkcji function* tworzy generator, który jest jednocześnie iteratorem i obiektem iterowalnym. next() wznawia wykonanie, yield oddaje element i zawiesza funkcję, a return ją kończy. for...of i składnia rozwinięcia ... pomijają wartość wyniku z done: true.

Generator przechowuje stan: jego ponowne użycie nie rozpoczyna iteracji od nowa. Wywołaj funkcję generatora ponownie, aby uzyskać nowy przebieg. Przykład pokazuje różnicę między elementami z yield a wartością końcową z return.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła