Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje