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

CKTIS / JavaScript

WeakMap.prototype.delete(): remover uma entrada pela chave

Remove uma entrada de um `WeakMap` e usa o valor booleano devolvido para saber se a entrada foi realmente removida.

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

Sintaxe

weakMap.delete(key)

WeakMap.prototype.delete é um método de instância. A chamada weakMap.delete(key) remove desse mapa a entrada associada a key. Só devolve true se remover uma entrada existente, mesmo que o valor guardado seja undefined. Se não houver uma entrada para essa chave, devolve false.

As chaves são comparadas pela sua identidade: dois objetos distintos com as mesmas propriedades são chaves diferentes. O ECMAScript 2024 admite objetos e símbolos não registados, como os criados com Symbol(). O suporte para símbolos como chaves varia consoante o ambiente de execução. Perante uma chave inválida, como uma cadeia de caracteres ou um símbolo obtido com Symbol.for(), delete() devolve false, ao passo que set() lança um TypeError. Uma chamada com um this inválido, como WeakMap.prototype.delete.call({}, key), também lança um TypeError.

O método remove imediatamente a associação. Não altera o objeto usado como chave, não remove nenhuma das suas propriedades como faria o operador delete, nem força a recolha de lixo. Usa-o quando já não precisares da associação guardada, mas a chave ainda estiver disponível.

Exemplos

{
  const weakMap = new WeakMap();
  const key = { id: 1 };
  weakMap.set(key, undefined);

  console.log(weakMap.delete({ id: 1 }));
  console.log(weakMap.delete(key));
  console.log(weakMap.has(key));
  console.log(weakMap.delete(key));
  console.log(weakMap.delete("id"));
}

Resultado

false
true
false
false
false

O novo objeto `{ id: 1 }` não corresponde à chave guardada. A chave original `key` permite remover a entrada mesmo que o valor seja `undefined`. A verificação com `has()`, a segunda remoção e a tentativa com uma cadeia de caracteres como chave devolvem `false`.

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