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

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

Fontes