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
keys()
Parameter
Keine.
Rückgabewert
Ein neues iterierbares Iterator-Objekt.
Beschreibung
Wenn die Methode auf Sparsame Arrays angewendet wird, iteriert die keys()-Methode über leere Plätze, als hätten sie den Wert undefined.
Die keys()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und ganzzahlig indizierte Eigenschaften hat.
Beispiele
Verwendung von keys() auf sparsamen Arrays
Im Gegensatz zu Object.keys(), das nur Schlüssel enthält, die tatsächlich im Array existieren, ignoriert der keys()-Iterator keine Lücken, die fehlende Eigenschaften darstellen.
const arr = ["a", , "c"];
const sparseKeys = Object.keys(arr);
const denseKeys = [...arr.keys()];
console.log(sparseKeys); // ['0', '2']
console.log(denseKeys); // [0, 1, 2]
Aufruf von keys() bei Nicht-Array-Objekten
Die keys()-Methode liest die length-Eigenschaft von this und liefert dann alle ganzzahligen Indizes zwischen 0 und length - 1. Kein Indexzugriff erfolgt tatsächlich.
const arrayLike = {
length: 3,
};
for (const entry of Array.prototype.keys.call(arrayLike)) {
console.log(entry);
}
// 0
// 1
// 2
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.keys |