Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakSet — zbiór ze słabymi referencjami

WeakSet przechowuje unikalne obiekty i niezarejestrowane symbole bez utrzymywania ich przy życiu wyłącznie przez członkostwo w zbiorze. Udostępnia add, has i delete, ale nie pozwala iterować po elementach ani odczytać ich liczby.

Wersja: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Składnia

new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)

WeakSet służy do oznaczania wartości, na przykład obiektów już przetworzonych. Obiekty są rozróżniane według tożsamości, nie zawartości: dwa osobne obiekty { id: 1 } są różnymi elementami. new WeakSet(iterable) dodaje wartości z przekazanego obiektu iterowalnego; konstruktor wymaga new.

WeakSet.prototype.add(value) dodaje element, ignoruje duplikaty i zwraca ten sam zbiór, umożliwiając łańcuchowe wywołania. WeakSet.prototype.has(value) zwraca informację o członkostwie jako boolean. WeakSet.prototype.delete(value) zwraca true, jeśli usunęło istniejący element, a w przeciwnym razie false.

Dozwolone są obiekty, w tym funkcje, oraz symbole niezarejestrowane przez Symbol.for. Dla niedozwolonych wartości, takich jak liczby, napisy, null czy wynik Symbol.for, add zgłasza TypeError, natomiast has i delete zwracają false. Obsługę symboli dodano w ECMAScript 2023; starsze silniki mogą przyjmować tylko obiekty. Specyfikacja języka nie jest tabelą zgodności przeglądarek: obsługę tej funkcji sprawdzaj w docelowym środowisku.

W przeciwieństwie do Set, WeakSet nie utrzymuje elementów przy życiu samym członkostwem. Odzyskanie pamięci nie ma gwarantowanego terminu. Nie ma size, iteracji, forEach ani clear; do sprawdzenia członkostwa trzeba mieć badaną wartość. Wybierz Set, jeśli potrzebujesz wyliczać elementy lub znać ich liczbę.

Przykłady

const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);

console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));

Wynik

true
false
true
true
true
false
false

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

Źródła