CKTIS / JavaScript
Array.prototype.keys: iterador de índices
keys devolve um iterador de índices consecutivos desde zero, incluindo posições vazias.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.keys()array.keys() devolve um iterador novo dos índices 0, 1, …. Não lê valores nem testa se a propriedade indexada existe, pelo que uma posição vazia recebe um índice normal. O iterador é de utilização única, também iterável e não altera o recetor.
O comprimento atual é verificado em cada next() e não congelado na criação. Um elemento acrescentado antes do fim pode adicionar um índice; encurtar o array pode terminar mais cedo. É genérico para recetores array-like, mas null/undefined lança TypeError. O exemplo mostra índices de posições vazias e um índice acrescentado durante a iteração.
Exemplos
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);Resultado
0,1,2 0 1 false