CKTIS / JavaScript
Map.prototype.get: ler um valor por chave
O método get devolve o valor guardado sob uma chave correspondente de Map, ou undefined quando essa entrada não existe.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
map.get(key)map.get(key) procura a chave sem conversão de tipo e não altera o Map nem a ordem. Para uma chave encontrada devolve exatamente o valor guardado, incluindo a mesma referência de objeto; para chave ausente devolve undefined.
As chaves usam SameValueZero: NaN corresponde a NaN e -0 a +0; objetos só por identidade. Como uma entrada pode conter deliberadamente undefined, o resultado de get não a distingue da ausência—use map.has(key).
O recetor tem de possuir dados internos de Map; objeto, Set ou Proxy não tratado como this lança TypeError. É padrão desde ECMAScript 2015. get não executa uma fábrica nem cria entradas; get-or-create deve usar has/set explicitamente e considerar undefined.
Exemplos
const key = { id: 7 };
const stored = { enabled: true };
const map = new Map([[key, stored], ["empty", undefined], [NaN, "not a number"]]);
console.log(map.get(key) === stored);
console.log(map.get({ id: 7 }));
console.log(map.get(NaN));
console.log(map.get("empty"), map.has("empty"));
console.log(map.get("missing"), map.has("missing"));
try {
Map.prototype.get.call({}, "x");
} catch (error) {
console.log(error instanceof TypeError);
}Resultado
true undefined not a number undefined true undefined false true