CKTIS / JavaScript
Set.prototype.clear() — uklanjanje svih elemenata
Set.prototype.clear() uklanja sve elemente iz postojećeg skupa Set i vraća undefined. Mijenja isti objekt pa praznu kolekciju vidi svaka referenca na taj objekt.
Verzija: 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() poziva se kao set.clear(), bez argumenata. Uklanja sve elemente; nakon poziva set.size iznosi 0. Poziv na praznom skupu Set također vraća undefined i ostavlja skup praznim.
Metoda mijenja postojeći objekt umjesto da stvara novi. Praznu kolekciju vide i druge varijable koje upućuju na taj skup. Dodjela new Set() jednoj varijabli nije isto: ostale reference i dalje upućuju na prethodni objekt.
Za razliku od set.delete(value), koji uklanja jedan određeni element i vraća booleovu vrijednost, clear() uklanja sve elemente i vraća undefined. Zato nije moguće upotrijebiti set.clear().add(value). Uklanjanje objekata iz skupa Set ne mijenja same objekte.
Metoda zahtijeva primatelja s internim utorom [[SetData]]; Set.prototype.clear.call({}) baca TypeError. Riječ je o značajci standardne biblioteke ECMAScript, a ne o Web API-ju. Jezična specifikacija nije tablica kompatibilnosti preglednika; provjerite dostupnost u ciljnom okruženju.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.