CKTIS / JavaScript
Map.prototype.set: escrever uma entrada
O método set adiciona ou atualiza um par chave–valor num Map e devolve o mesmo Map, permitindo encadeamento.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
map.set(key, value)map.set(key, value) guarda sem conversão e devolve o Map recetor. Uma chave nova é acrescentada ao fim da ordem de inserção. Atualizar uma chave substitui o valor sem alterar size nem a posição; só delete seguido de set cria nova posição no fim.
As chaves usam SameValueZero: NaN corresponde a NaN e -0 é normalizado para +0. Chaves e valores objeto mantêm as mesmas referências, sem clonagem. O retorno permite map.set(a, 1).set(b, 2).
O recetor tem de possuir dados internos de Map; objeto, Set ou Proxy não tratado lança TypeError. Padrão desde ECMAScript 2015. Em get-or-create, um valor existente pode ser undefined, pelo que get sozinho nem sempre prova presença.
Exemplos
const map = new Map();
console.log(map.set("a", 1) === map);
map.set("b", 2).set("a", 3);
console.log(map.size, [...map.keys()].join(","), map.get("a"));
map.delete("a");
map.set("a", 4);
console.log([...map.keys()].join(","));
const key = {};
const value = {};
map.set(key, value);
console.log(map.get(key) === value);
map.set(NaN, 1).set(NaN, 2).set(-0, "zero");
console.log(map.get(NaN), map.get(+0));
try { Map.prototype.set.call({}, "x", 1); } catch (error) { console.log(error instanceof TypeError); }Resultado
true 2 a,b 3 b,a true 2 zero true