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
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262