CKTIS / JavaScript
Array.prototype.values: iterátor hodnôt
values vráti živý iterátor, ktorý číta postupné indexované hodnoty vrátane undefined vzniknutého z dier.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
array.values()array.values() vytvorí iterátor hodnôt bez kopírovania prvkov. Každé next() prečíta aktuálny index a znovu overí length, takže zmeny prijímateľa vykonané pred návštevou pozície môžu byť viditeľné. Výsledok kroku obsahuje value a done; po vyčerpaní iterátor zostane vyčerpaný.
Diery sa nepreskakujú: bežné čítanie chýbajúceho indexu dá undefined. Iterátor je sám iterovateľný a Array.prototype[Symbol.iterator] spočiatku odkazuje na rovnakú funkciu ako values. Metóda nemení a je všeobecná pre array-like hodnoty.
Vytvorenie vyžaduje prijímateľa iného než null či undefined, inak vyvolá TypeError. Prevod length, indexované gettery a proxy trapy prebiehajú počas iterácie, takže ich chyby vystúpia z next(). API bolo štandardizované v ECMAScript 2015.
Prí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ýsledok
build false undefined false deploy false true test release true