WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.keys: Iterator der Indizes

keys liefert einen Iterator fortlaufender Indizes ab null, auch für Lücken.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.keys()

array.keys() liefert einen neuen Iterator der Indizes 0, 1, …. Werte werden nicht gelesen und indizierte Eigenschaften nicht geprüft, daher erhält auch eine Lücke einen normalen Index. Der Iterator ist einmalig, selbst iterierbar und mutiert den Empfänger nicht.

Die aktuelle Länge wird bei jedem next() geprüft und nicht bei der Erzeugung eingefroren. Ein vor dem Ende angehängtes Element kann daher einen Index hinzufügen; Verkürzen kann früher beenden. Die Methode ist für array-ähnliche Empfänger generisch, null/undefined löst jedoch TypeError aus. Das Beispiel zeigt Indizes leerer Plätze und einen während der Iteration angehängten Index.

Beispiele

console.log([...new Array(3).keys()].join(","));
const values = ["A"];
const iterator = values.keys();
console.log(iterator.next().value);
values.push("B");
const appended = iterator.next();
console.log(appended.value, appended.done);

Ergebnis

0,1,2
0
1 false

Quellen