KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen