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

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

Fontes