CKTIS / JavaScript
Set.prototype.clear() — odstránenie všetkých prvkov
Set.prototype.clear() odstráni všetky prvky z existujúcej množiny Set a vráti undefined. Mení ten istý objekt, takže prázdnu kolekciu uvidí každý odkaz na tento objekt.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.clear()Set.prototype.clear() sa volá ako set.clear() bez argumentov. Odstráni všetky prvky; potom má set.size hodnotu 0. Volanie na prázdnej množine Set tiež vráti undefined a ponechá ju prázdnu.
Metóda mení existujúci objekt namiesto vytvorenia nového. Prázdnu kolekciu uvidia aj ostatné premenné odkazujúce na túto množinu. Priradenie new Set() jednej premennej nie je to isté: ostatné odkazy stále ukazujú na predchádzajúci objekt.
Na rozdiel od set.delete(value), ktoré odstráni jeden určený prvok a vráti logickú hodnotu, clear() odstráni všetky prvky a vráti undefined. Preto nemožno použiť set.clear().add(value). Odstránenie objektov z množiny Set nemení samotné objekty.
Metóda vyžaduje prijímateľa s interným slotom [[SetData]]; Set.prototype.clear.call({}) vyvolá TypeError. Ide o funkciu štandardnej knižnice ECMAScript, nie o Web API. Jazyková špecifikácia nie je tabuľkou kompatibility prehliadačov; dostupnosť overte v cieľovom prostredí.
Príklady
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);Výsledok
0 true 0 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.