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
- ECMAScript 2024 Language Specification — WeakMap.prototype.delete (key)
- ECMAScript Language Specification — WeakMap.prototype.delete (key)
- ECMAScript 2024 Language Specification — CanBeHeldWeakly (v)
- ECMAScript 2024 Language Specification — WeakMap Objects
- ECMAScript 2024 Language Specification — The delete Operator
- MDN — WeakMap.prototype.delete()
- MDN — WeakMap browser compatibility