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.