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

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.

Fontes