Array.prototype.keys()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2018.

Die keys()-Methode von Array Instanzen gibt ein neues Array-Iterator-Objekt zurück, das die Schlüssel für jeden Index im Array enthält.

Probieren Sie es aus

const array1 = ["a", "b", "c"];
const iterator = array1.keys();

for (const key of iterator) {
  console.log(key);
}

// Expected output: 0
// Expected output: 1
// Expected output: 2

Syntax

js
keys()

Parameter

Keine.

Rückgabewert

Ein neues iterierbares Iterator-Objekt.

Beschreibung

Bei der Verwendung auf sparse Arrays durchläuft die keys()-Methode leere Slots, als ob sie den Wert undefined hätten.

Die keys()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integer-beschlüsselte Eigenschaften hat.

Beispiele

Verwendung von keys() auf sparsamen Arrays

Anders als Object.keys(), das nur Schlüssel einschließt, die tatsächlich im Array vorhanden sind, ignoriert der keys()-Iterator keine Lücken, die fehlende Eigenschaften darstellen.

js
const arr = ["a", , "c"];
const sparseKeys = Object.keys(arr);
const denseKeys = [...arr.keys()];
console.log(sparseKeys); // ['0', '2']
console.log(denseKeys); // [0, 1, 2]

Aufrufen von keys() auf Nicht-Array-Objekten

Die keys()-Methode liest die length-Eigenschaft von this und liefert alle Ganzzahlindizes zwischen 0 und length - 1. Es erfolgt kein tatsächlicher Indexzugriff.

js
const arrayLike = {
  length: 3,
};
for (const entry of Array.prototype.keys.call(arrayLike)) {
  console.log(entry);
}
// 0
// 1
// 2

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-array.prototype.keys

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch