CKTIS / JavaScript
Set.prototype.clear() — odstranění všech prvků
Set.prototype.clear() odstraní všechny prvky z existující množiny Set a vrátí undefined. Mění tentýž objekt, takže prázdnou kolekci uvidí každý odkaz na tento objekt.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
set.clear()Set.prototype.clear() se volá jako set.clear() bez argumentů. Odstraní všechny prvky; potom má set.size hodnotu 0. Volání na prázdné množině Set také vrátí undefined a ponechá ji prázdnou.
Metoda mění existující objekt, místo aby vytvářela nový. Prázdnou kolekci uvidí i ostatní proměnné odkazující na tuto množinu. Přiřazení new Set() jedné proměnné není totéž: ostatní odkazy stále ukazují na předchozí objekt.
Na rozdíl od set.delete(value), které odstraní jeden určený prvek a vrátí logickou hodnotu, clear() odstraní všechny prvky a vrátí undefined. Nelze tedy použít set.clear().add(value). Odstranění objektů z množiny Set nemění samotné objekty.
Metoda vyžaduje příjemce s interním slotem [[SetData]]; Set.prototype.clear.call({}) vyvolá TypeError. Jde o funkci standardní knihovny ECMAScript, nikoli o Web API. Jazyková specifikace není tabulkou kompatibility prohlížečů; dostupnost ověřte v cílovém prostředí.
Pří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ýsledek
0 true 0 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.