Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes