Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.keys: iterator indeksów

keys zwraca iterator kolejnych indeksów od zera, także dla dziur w tablicy.

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

Składnia

array.keys()

array.keys() zwraca nowy iterator indeksów 0, 1, …. Nie odczytuje wartości i nie sprawdza, czy właściwość pod indeksem istnieje, dlatego dziury otrzymują normalny indeks. Iterator jest jednorazowy, sam jest iterable i nie mutuje odbiorcy.

Bieżąca długość jest sprawdzana przy każdym next(), a nie zamrażana przy tworzeniu iteratora. Element dopisany przed zakończeniem może więc dodać indeks; skrócenie tablicy może zakończyć iterację wcześniej. Metoda jest generyczna dla array-like, ale odbiorca null/undefined powoduje TypeError. Przykład pokazuje indeksy pustej tablicy i indeks dopisany podczas iteracji.

Przykłady

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

Wynik

0,1,2
0
1 false

Źródła