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

CKTIS / JavaScript

Map.prototype.values: iterador de valores

O método values devolve um iterador vivo dos valores de Map pela ordem de inserção das chaves correspondentes.

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

Sintaxe

map.values()

map.values() cria um novo iterador de Map. Cada next() bem-sucedido devolve o valor da entrada seguinte. Objetos mantêm as mesmas referências e valores iguais sob chaves diferentes são devolvidos separadamente; não há deduplicação.

O iterador é preguiçoso, não uma captura. Ignora entrada eliminada antes da visita, uma atualização anterior fornece o valor novo e uma adição antes do fim pode aparecer. Atualizar chave já visitada não a repete. Após done: true, adições posteriores não o retomam.

O método não aceita argumentos significativos e exige dados internos de Map; objeto, Set ou Proxy não tratado lança TypeError. Padrão desde ECMAScript 2015. Para manter a associação com chaves, use entries().

Exemplos

const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }

Resultado

true
20
4
true
true
1,1
true

Fontes