Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.keys: iterátor indexů

keys vrací iterátor po sobě jdoucích indexů od nuly včetně děr.

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

Syntaxe

array.keys()

array.keys() vrátí nový iterátor indexů 0, 1, …. Nečte hodnoty ani netestuje existenci indexované vlastnosti, takže díra dostane běžný index. Iterátor je jednorázový, sám iterovatelný a příjemce nemění.

Aktuální délka se kontroluje při každém next() a při vytvoření se nezmrazí. Prvek přidaný před dokončením tedy může přidat index; zkrácení může iteraci ukončit dříve. Metoda je obecná pro array-like příjemce, ale null/undefined vyvolá TypeError. Příklad ukazuje indexy děr a index přidaný během iterace.

Příklady

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

Výsledek

0,1,2
0
1 false

Zdroje