Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.values: iterator wartości

values zwraca żywy iterator, który odczytuje kolejne wartości indeksowe, w tym undefined pochodzące z dziur.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

array.values()

array.values() tworzy iterator wartości bez kopiowania elementów. Każde next() odczytuje bieżący indeks i ponownie sprawdza length, dlatego zmiany odbiorcy wykonane przed odwiedzeniem pozycji mogą być widoczne. Wynik kroku ma pola value i done; po zakończeniu iterator pozostaje zakończony.

Dziury nie są pomijane: zwykły odczyt brakującego indeksu daje undefined. Iterator sam jest iterowalny, a Array.prototype[Symbol.iterator] jest początkowo tą samą funkcją co values. Metoda nie mutuje i jest generyczna dla array-like.

Samo utworzenie wymaga odbiorcy innego niż null i undefined, inaczej zgłasza TypeError. Konwersja length, gettery indeksów i proxy trapy są wykonywane podczas iteracji, więc ich błędy wychodzą z next(). API pochodzi z ECMAScript 2015.

Przykłady

const sparse = ["build", , "deploy"];
const iterator = sparse.values();
for (let step = iterator.next(); !step.done; step = iterator.next()) {
  console.log(String(step.value), step.done);
}
console.log(iterator.next().done);

const tasks = ["test"];
const live = tasks.values();
console.log(live.next().value);
tasks.push("release");
console.log(live.next().value, live.next().done);

Wynik

build false
undefined false
deploy false
true
test
release true

Źródła