CKTIS / JavaScript
Set.prototype.delete — remover um valor de um conjunto
Set.prototype.delete(value) remove o valor indicado de um conjunto existente. Devolve true se o valor for removido ou false se estiver ausente. Os objetos são comparados pela identidade, e não pelo conteúdo.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
set.delete(value)set.delete(value) altera um Set existente: remove o valor correspondente e devolve true. Se o valor estiver ausente, devolve false sem alterar o conjunto. O argumento indica um valor, não um índice. O resultado é um booleano, não o conjunto, pelo que não é possível encadear chamadas consecutivas a .delete().
A comparação segue a semântica SameValueZero: NaN corresponde a NaN, e +0 e -0 são considerados o mesmo valor. Os objetos são comparados pela identidade. Um novo objeto { id: 1 } não corresponde a um objeto adicionado anteriormente com os mesmos campos; é necessário passar uma referência para o mesmo objeto.
Não confundas este método com o operador delete, que remove propriedades dos objetos, nem com set.clear(), que remove todos os elementos. O método requer um recetor com dados internos de Set; chamar Set.prototype.delete.call({}, value) lança um TypeError. Esta é uma API da linguagem ECMAScript, não uma API do navegador; a mera presença de Node.js num projeto não confirma o suporte nos navegadores de destino.
Exemplos
const item = { id: 1 };
const values = new Set(["ready", item, NaN]);
console.log(values.delete("ready"));
console.log(values.delete("ready"));
console.log(values.delete({ id: 1 }));
console.log(values.delete(item));
console.log(values.delete(NaN));
console.log(values.size);Resultado
true false false true true 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.