CKTIS / JavaScript
Map.prototype.keys: iterador de chaves
O método keys devolve um iterador vivo das chaves de Map pela ordem de inserção sem copiar os valores associados.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
map.keys()map.keys() cria um novo iterador de Map. Cada next() bem-sucedido devolve a chave seguinte pela ordem de inserção; chaves objeto são as mesmas referências. O iterador não altera o Map e chamadas separadas a keys() têm posições independentes.
O iterador é preguiçoso, não uma captura. Ignora entrada eliminada antes da visita e pode ver entrada adicionada antes do fim. Atualizar o valor de uma chave não cria nova posição. Após done: true, adições posteriores não o retomam. Uma chave -0 é guardada e devolvida como +0.
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 obter também valores, use entries() ou a iteração predefinida.
Exemplos
const objectKey = {};
const map = new Map([[objectKey, 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value === objectKey);
map.delete("b");
map.set("c", 3);
const second = keys.next();
console.log(second.value, second.done);
console.log(keys.next().done);
map.set("d", 4);
console.log(keys.next().done);
const zeroKey = new Map([[-0, "zero"]]).keys().next().value;
console.log(Object.is(zeroKey, 0));
try { Map.prototype.keys.call({}); } catch (error) { console.log(error instanceof TypeError); }Resultado
true c false true true true true