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

CKTIS / JavaScript

Array.prototype.entries: iterador de pares índice–valor

entries devolve um iterador de pares consecutivos de índice e valor, incluindo posições vazias de um array esparso.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.entries()

array.entries() devolve um iterador novo. Cada next() produz [index, value] de zero ao comprimento atual. Uma posição vazia é lida como undefined e não ignorada como em muitos métodos com callback.

O iterador é consumido uma vez e também é iterável. Não é uma fotografia: mudanças de comprimento ou valor antes da visita podem afetar o resultado. É genérico para recetores array-like; null ou undefined lança TypeError. O exemplo materializa os três índices incluindo a posição vazia.

Exemplos

const values = ["A", , "C"];
const rendered = [...values.entries()].map(([index, value]) => `${index}:${value}`);
console.log(rendered.join("|"));

Resultado

0:A|1:undefined|2:C

Fontes