Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.keys: iteratore degli indici

keys restituisce un iteratore di indici consecutivi da zero, inclusi i vuoti.

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

Sintassi

array.keys()

array.keys() restituisce un nuovo iteratore degli indici 0, 1, …. Non legge valori né verifica l’esistenza della proprietà indicizzata, quindi un vuoto riceve un indice normale. L’iteratore è monouso, è esso stesso iterabile e non muta il ricevente.

La lunghezza corrente è controllata a ogni next() e non congelata alla creazione. Un elemento aggiunto prima della fine può quindi aggiungere un indice; accorciare l’array può terminare prima. È generico per riceventi array-like, ma null/undefined genera TypeError. L’esempio mostra indici dei vuoti e un indice aggiunto durante l’iterazione.

Esempi

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

Risultato

0,1,2
0
1 false

Fonti