CKTIS / JavaScript
Set.prototype.clear() — odstranjevanje vseh elementov
Set.prototype.clear() odstrani vse elemente iz obstoječega nabora Set in vrne undefined. Spremeni isti objekt, zato prazno zbirko vidijo vse reference na ta objekt.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.clear()Set.prototype.clear() pokličete kot set.clear(), brez argumentov. Odstrani vse elemente; po klicu je set.size enak 0. Tudi klic na praznem naboru Set vrne undefined in ga pusti praznega.
Metoda spremeni obstoječi objekt, namesto da bi ustvarila novega. Prazno zbirko vidijo tudi druge spremenljivke, ki se sklicujejo na ta nabor. Dodelitev new Set() eni spremenljivki ni enakovredna: druge reference še vedno kažejo na prejšnji objekt.
Za razliko od set.delete(value), ki odstrani določen element in vrne logično vrednost, clear() odstrani vse elemente in vrne undefined. Zato ni mogoče uporabiti set.clear().add(value). Odstranjevanje objektov iz nabora Set ne spremeni samih objektov.
Metoda zahteva prejemnika z notranjim mestom [[SetData]]; Set.prototype.clear.call({}) sproži TypeError. To je funkcija standardne knjižnice ECMAScript, ne spletni API. Jezikovna specifikacija ni tabela združljivosti brskalnikov; razpoložljivost preverite v ciljnem okolju.
Primeri
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);Rezultat
0 true 0 true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.