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

CKTIS / JavaScript

WeakMap.prototype.delete() — remover uma entrada

Chama `weakMap.delete(key)` para remover a entrada associada a uma chave. O método devolve `true` se removeu uma entrada e `false` se não a removeu.

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

Sintaxe

weakMap.delete(key)

WeakMap.delete é uma designação abreviada do método de instância WeakMap.prototype.delete. Chama-o como weakMap.delete(key), não como método estático do construtor WeakMap. Remove a associação entre a chave e o valor apenas desse mapa. Ao contrário do operador delete, não remove propriedades de um objeto.

true indica que existia uma entrada e que esta foi removida, mesmo que o seu valor fosse undefined. Se a entrada não existir, o resultado é false. As chaves que são objetos são comparadas pela sua identidade: dois objetos distintos com as mesmas propriedades não coincidem. Após a remoção, weakMap.has(key) devolve false, a menos que voltes a adicionar uma entrada para essa chave.

ECMAScript 2024 aceita como chaves objetos e símbolos não registados, como Symbol(), mas não símbolos obtidos com Symbol.for(). O suporte para chaves do tipo símbolo depende do ambiente de execução. Numa instância válida, delete() devolve false se a chave for inválida, como uma cadeia de caracteres, ou se omitires o argumento; set() lança TypeError para uma chave inválida. Chamar delete() sem uma instância válida como this também lança TypeError.

Um WeakMap não mantém um objeto vivo só por este servir de chave. A remoção explícita elimina a entrada de imediato, mesmo que o código ainda tenha uma referência à chave. Não destrói o objeto nem força a recolha de lixo.

Exemplos

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

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

Resultado

false
true
false
false
false

O objeto distinto `{ id: 1 }` não coincide com `key`. A remoção com `key` devolve `true` apesar de o valor guardado ser `undefined`. Depois, `has()`, uma segunda remoção e uma tentativa com uma cadeia de caracteres como chave devolvem `false`.

Lições relacionadas

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

Fontes