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

CKTIS / JavaScript

WeakMap.prototype.has(): verificar se uma chave está presente

`weakMap.has(key)` verifica se o mapa contém uma entrada para essa chave, mesmo quando o valor guardado é `undefined`.

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

Sintaxe

weakMap.has(key)

WeakMap.prototype.has é um método de instância, não um método estático. A chamada weakMap.has(key) devolve true se esse mapa contiver uma entrada para a chave e false caso contrário. Não altera o mapa. As chaves são comparadas pela sua identidade: dois objetos distintos com as mesmas propriedades são chaves diferentes.

Usa has() para distinguir uma entrada em falta de uma entrada cujo valor é undefined. Em ambos os casos, get() devolve undefined.

O ECMAScript 2024 admite como chaves objetos (incluindo funções) e símbolos não registados, como Symbol('id'). Ambientes de execução mais antigos podem aceitar apenas objetos como chaves. Para uma chave inválida, como uma cadeia de caracteres ou um símbolo obtido com Symbol.for('id'), has() devolve false, enquanto set() lança um TypeError.

Um this inválido é um caso diferente: o método exige uma instância de WeakMap como this. Assim, const has = weakMap.has; has(key); lança um TypeError em vez de devolver false.

Uma entrada num WeakMap não impede, por si só, que o mecanismo de recolha de lixo liberte a memória ocupada pela chave. has() exige que forneças a chave e não permite enumerar as chaves nem saber quando ocorreu a recolha de lixo.

Exemplos

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

  weakMap.set(key, undefined);

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

Resultado

true
undefined
false
undefined
false

Ambas as chamadas a `get()` devolvem `undefined`, mas só `has(key)` devolve `true`. `otherKey` tem as mesmas propriedades, mas é um objeto diferente, e a cadeia `"id"` não é uma chave válida.

Lições relacionadas

  • JavaScript · Lição 10 · Intermédio · Versão: 3

Fontes