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

CKTIS / JavaScript

WeakMap.get() — ler um valor pela chave

`weakMap.get(key)` devolve o valor associado a uma chave. Usa `has(key)` para distinguir uma entrada inexistente de outra com o valor `undefined`.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

weakMap.get(key)

WeakMap.get é uma forma abreviada de referir o método de instância WeakMap.prototype.get, não um método estático do construtor. weakMap.get(key) lê o valor guardado sem alterar o mapa. As chaves são comparadas pela sua identidade: dois objetos criados separadamente com as mesmas propriedades são chaves diferentes. Se o valor guardado for um objeto, get() devolve esse mesmo objeto, não uma cópia.

Tanto uma entrada inexistente como uma entrada com o valor undefined dão undefined. Usa weakMap.has(key) para as distinguir: o método devolve true quando a entrada existe, mesmo que o seu valor seja undefined.

O ECMAScript 2024 aceita como chaves objetos, incluindo funções, e símbolos não registados, como Symbol('id'). Motores mais antigos podem suportar WeakMap sem aceitar símbolos como chaves. Numa instância de WeakMap, get() devolve undefined para uma chave inválida, como uma cadeia de caracteres ou um símbolo devolvido por Symbol.for(), enquanto set() lança um TypeError. O próprio get() lança um TypeError se o seu this não for uma instância de WeakMap, por exemplo, se chamares o método em separado sem o associares a uma instância.

O mapa, por si só, não mantém uma chave viva. Quando a chave deixa de ser alcançável, a entrada correspondente pode ser removida durante a recolha de lixo. Não podes enumerar as chaves nem contar com a remoção de uma entrada num momento específico.

Exemplos

const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Resultado

42
undefined
undefined
true
undefined

`key` e `otherKey` são objetos distintos, apesar de terem as mesmas propriedades. As duas consultas de `otherKey` devolvem `undefined`: primeiro, a entrada não existe; depois, existe com o valor `undefined`, como confirma `has()`. A última consulta usa uma chave inválida.

Lições relacionadas

  • JavaScript · Lição 18 · Básico · Versão: 4

Fontes