Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri