Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje