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