CKTIS / JavaScript
Array.prototype.values: waardeniterator
values retourneert een levende iterator die opeenvolgende indexwaarden leest, inclusief undefined uit gaten.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
array.values()array.values() maakt een waardeniterator zonder elementen te kopiëren. Elke next() leest de huidige index en controleert length opnieuw, zodat wijzigingen vóór het bezoeken van een positie zichtbaar kunnen zijn. Een stapresultaat bevat value en done; na uitputting blijft de iterator uitgeput.
Gaten worden niet overgeslagen: normaal lezen van een ontbrekende index geeft undefined. De iterator is zelf iterabel en Array.prototype[Symbol.iterator] verwijst aanvankelijk naar dezelfde functie als values. De methode muteert niet en is generiek voor array-achtige waarden.
Voor creatie mag de ontvanger niet null of undefined zijn, anders wordt TypeError geworpen. Lengteconversie, indexgetters en proxytraps vinden tijdens iteratie plaats; hun fouten komen dus uit next(). De API is gestandaardiseerd in ECMAScript 2015.
Voorbeelden
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);Resultaat
build false undefined false deploy false true test release true