Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.clear() — usuwanie wszystkich elementów

Metoda Set.prototype.clear() usuwa wszystkie elementy istniejącego zbioru Set i zwraca undefined. Zmienia ten sam obiekt, więc efekt jest widoczny przez wszystkie odwołania do niego.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

set.clear()

Set.prototype.clear() wywołuje się jako set.clear(), bez argumentów. Usuwa wszystkie elementy zbioru; po wywołaniu set.size wynosi 0. Wywołanie na pustym zbiorze również zwraca undefined i pozostawia go pustym.

Metoda zmienia istniejący obiekt, zamiast tworzyć nowy. Inne zmienne wskazujące ten sam zbiór także zobaczą pustą kolekcję. Przypisanie new Set() do jednej zmiennej nie jest równoważne: pozostałe odwołania nadal wskazują poprzedni obiekt.

W przeciwieństwie do set.delete(value), które usuwa jeden wskazany element i zwraca wartość logiczną, clear() usuwa wszystkie elementy i zwraca undefined. Nie można więc użyć set.clear().add(value). Usunięcie obiektów ze zbioru nie modyfikuje samych obiektów.

Metoda wymaga odbiorcy z wewnętrznym polem [[SetData]]; Set.prototype.clear.call({}) zgłasza TypeError. Jest to funkcja biblioteki standardowej ECMAScript, a nie Web API. Specyfikacja języka nie jest tabelą obsługi przeglądarek; dostępność należy sprawdzić w docelowym środowisku.

Przykłady

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);

Wynik

0
true
0
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła