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.