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

CKTIS / JavaScript

WeakMap.prototype.get() — ler um valor pela sua chave

Usa `weakMap.get(key)` para ler um valor sem alterar o mapa. Usa `has()` para distinguir uma entrada inexistente de uma entrada com o valor `undefined`.

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

Sintaxe

weakMap.get(key)

WeakMap.prototype.get é um método de instância que se invoca como weakMap.get(key). Devolve o valor associado à chave, sem adicionar nem alterar entradas. Se o valor guardado for um objeto, devolve esse mesmo objeto, não uma cópia.

As chaves são comparadas pela sua identidade: dois objetos distintos com propriedades idênticas são chaves diferentes. O ECMAScript 2024 admite objetos e símbolos não registados como chaves, por exemplo os criados com Symbol(), mas não os obtidos com Symbol.for(). Os ambientes de execução mais antigos podem não suportar símbolos como chaves.

get() devolve undefined se a entrada não existir, se a chave for inválida (por exemplo, uma cadeia de caracteres) ou se o valor guardado for undefined. Usa weakMap.has(key) para distinguir um undefined guardado (true) de uma entrada inexistente (false). Ao contrário de get(), set() lança um TypeError se a chave for inválida. O próprio get() lança um TypeError se this não for uma instância de WeakMap, por exemplo se guardares o método numa variável e o invocares sem o associares ao mapa.

Um WeakMap não mantém uma chave viva só por a guardar. Não podes enumerar as suas chaves nem prever quando o coletor de lixo irá recuperar a memória de uma chave que deixou de ser alcançável.

Exemplos

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

  weakMap.set(key, 42);
  weakMap.set(pending, undefined);

  console.log(weakMap.get(key));
  console.log(weakMap.get(lookalike));
  console.log(weakMap.get(pending));
  console.log(weakMap.has(pending));
  console.log(weakMap.has(lookalike));
  console.log(weakMap.get("id"));
}

Resultado

42
undefined
undefined
true
false
undefined

`lookalike` tem as mesmas propriedades que `key`, mas é um objeto diferente. `get()` devolve `undefined` tanto para `lookalike` como para `pending`, mas `has()` só devolve `true` para `pending`. A consulta com a cadeia `"id"` devolve `undefined` sem lançar uma exceção.

Lições relacionadas

  • JavaScript · Lição 35 · Básico · Versão: 4
  • JavaScript · Lição 37 · Básico · Versão: 4
  • JavaScript · Lição 4 · Intermédio · Versão: 3
  • JavaScript · Lição 10 · Intermédio · Versão: 3

Fontes