CKTIS / JavaScript
Array.prototype.values: iterátor hodnot
values vrátí živý iterátor, který čte postupné indexované hodnoty včetně undefined vzniklého z děr.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
array.values()array.values() vytvoří iterátor hodnot bez kopírování prvků. Každé next() přečte aktuální index a znovu ověří length, takže změny příjemce provedené před návštěvou pozice mohou být vidět. Výsledek kroku obsahuje value a done; po vyčerpání iterátor zůstane vyčerpaný.
Díry se nepřeskakují: běžné čtení chybějícího indexu dá undefined. Iterátor je sám iterovatelný a Array.prototype[Symbol.iterator] zpočátku odkazuje na stejnou funkci jako values. Metoda nemutuje a je obecná pro array-like hodnoty.
Vytvoření vyžaduje příjemce jiného než null či undefined, jinak vyvolá TypeError. Převod length, indexované gettery a proxy trapy probíhají během iterace, takže jejich chyby vystoupí z next(). API bylo standardizováno v ECMAScript 2015.
Příklady
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);Výsledek
build false undefined false deploy false true test release true