Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.clear() — rimuovere tutti gli elementi

Set.prototype.clear() rimuove tutti gli elementi da un Set esistente e restituisce undefined. Modifica lo stesso oggetto, quindi ogni riferimento a quell’oggetto vede la raccolta svuotata.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

set.clear()

Chiama Set.prototype.clear() come set.clear(), senza argomenti. Rimuove tutti gli elementi; dopo la chiamata, set.size è 0. Anche se chiamato su un Set vuoto, restituisce undefined e lo lascia vuoto.

Il metodo modifica l’oggetto esistente invece di crearne uno nuovo. Anche le altre variabili che fanno riferimento a quel Set vedono una raccolta vuota. Assegnare new Set() a una variabile non è equivalente: gli altri riferimenti continuano a puntare all’oggetto precedente.

A differenza di set.delete(value), che rimuove un elemento specificato e restituisce un valore booleano, clear() rimuove tutti gli elementi e restituisce undefined. Di conseguenza, non è possibile usare set.clear().add(value). Rimuovere oggetti dal Set non modifica gli oggetti stessi.

Il metodo richiede un ricevitore con lo slot interno [[SetData]]; Set.prototype.clear.call({}) genera un TypeError. È una funzionalità della libreria standard ECMAScript, non una Web API. La specifica del linguaggio non è una tabella di compatibilità dei browser; verifica la disponibilità nell’ambiente di destinazione.

Esempi

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);

Risultato

0
true
0
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti