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