WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.values: Werteiterator

values gibt einen lebenden Iterator zurück, der aufeinanderfolgende Indexwerte einschließlich undefined aus Lücken liest.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

array.values()

array.values() erstellt ohne Elementkopie einen Werteiterator. Jedes next() liest den aktuellen Index und prüft length erneut; Änderungen vor dem Besuch einer Position können daher sichtbar sein. Ein Schrittergebnis enthält value und done; nach dem Ende bleibt der Iterator beendet.

Lücken werden nicht übersprungen: Das normale Lesen eines fehlenden Index ergibt undefined. Der Iterator ist selbst iterierbar, und Array.prototype[Symbol.iterator] verweist anfangs auf dieselbe Funktion wie values. Die Methode mutiert nicht und ist für array-ähnliche Werte generisch.

Zur Erzeugung darf der Empfänger nicht null oder undefined sein, sonst entsteht TypeError. Längenkonvertierung, Index-Getter und Proxy-Traps geschehen bei der Iteration; ihre Fehler treten daher aus next() aus. Das API wurde in ECMAScript 2015 standardisiert.

Beispiele

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);

Ergebnis

build false
undefined false
deploy false
true
test
release true

Quellen