CKTIS / JavaScript
Set.prototype.clear() — remover todos os elementos
Set.prototype.clear() remove todos os elementos de um Set existente e devolve undefined. Altera o mesmo objeto, pelo que todas as referências a esse objeto observam a coleção vazia.
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.clear()Chame Set.prototype.clear() como set.clear(), sem argumentos. O método remove todos os elementos; depois, set.size é 0. Se for chamado num Set vazio, também devolve undefined e deixa-o vazio.
O método altera o objeto existente em vez de criar um novo. As outras variáveis que referenciam esse Set também observam uma coleção vazia. Atribuir new Set() a uma variável não é equivalente: as outras referências continuam a apontar para o objeto anterior.
Ao contrário de set.delete(value), que remove um elemento especificado e devolve um valor booleano, clear() remove todos os elementos e devolve undefined. Por isso, não é possível usar set.clear().add(value). Remover objetos do Set não altera os próprios objetos.
O método requer um recetor com o slot interno [[SetData]]; Set.prototype.clear.call({}) lança um TypeError. É uma funcionalidade da biblioteca padrão ECMAScript, não uma Web API. A especificação da linguagem não é uma tabela de compatibilidade dos browsers; verifique a disponibilidade no ambiente de destino.
Exemplos
const values = new Set([1, 2, 3]);
const alias = values;
const result = values.clear();
console.log(values.size);
console.log(alias === values);
console.log(alias.size);
console.log(result === undefined);Resultado
0 true 0 true
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.