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

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.

Fontes