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

CKTIS / JavaScript

Map.prototype.entries: iterador de pares chave–valor

O método entries devolve um iterador vivo de pares [key, value] pela ordem de inserção e é a iteração predefinida de Map.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

map.entries()

map.entries() cria um novo objeto iterador de Map. Cada next() bem-sucedido devolve um array novo de dois elementos [key, value]; alterar esse array não muda a entrada do Map, embora os objetos contidos continuem a ser as mesmas referências. map[Symbol.iterator] é a mesma função que map.entries, pelo que for...of e spread recebem pares por predefinição.

O iterador é preguiçoso, não uma captura. Preserva a ordem de inserção, ignora entradas eliminadas antes da visita e pode ver entradas adicionadas antes de chegar ao fim; atualizar uma chave ainda não visitada fornece o novo valor. Depois de next() devolver done: true, adições posteriores não retomam esse iterador.

O método não aceita argumentos significativos e exige um recetor com dados internos de Map; usá-lo com objeto, Set ou Proxy não tratado lança TypeError. É padrão desde ECMAScript 2015. Quando só são necessárias chaves ou valores, keys() ou values() evitam arrays de pares.

Exemplos

const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));

map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);

map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);

Resultado

["a",1]
1
["c",3] false
true
true
true

Fontes