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.