CKTIS / JavaScript
WeakSet: sprawdzanie, dodawanie i usuwanie elementów
Użyj `has()`, aby sprawdzić, czy wartość należy do zbioru, `add()`, aby ją dodać, i `delete()`, aby ją usunąć. Metody różnią się wynikiem i reakcją na niedozwoloną wartość.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete to skrótowe określenie trzech metod prototypu WeakSet, a nie nazwa jednej metody. Wywołuj je na instancji, np. seen.has(value). Wywołanie metody bez instancji WeakSet jako this zgłasza TypeError, także wtedy, gdy odłączysz metodę od instancji i wywołasz ją jako zwykłą funkcję.
has(value) zwraca true, jeśli wartość należy do zbioru, a w przeciwnym razie false; nie zmienia zbioru. add(value) dodaje wartość tylko wtedy, gdy jeszcze jej nie ma, i zawsze po udanym wywołaniu zwraca tę samą instancję, więc wywołania można łączyć w łańcuch. delete(value) zwraca true tylko wtedy, gdy usunęła element; w przeciwnym razie zwraca false. Przy sprawdzaniu przynależności liczy się tożsamość, nie zawartość: dwa osobno utworzone obiekty { id: 1 } są różnymi elementami.
ECMAScript 2024 dopuszcza obiekty (w tym funkcje) oraz niezarejestrowane symbole, np. Symbol(). Symbole z globalnego rejestru, zwracane przez Symbol.for(), oraz pozostałe wartości prymitywne, np. 1 i null, są niedozwolone. Dla niedozwolonej wartości add() zgłasza TypeError, natomiast has() i delete() zwracają false. Starsze środowiska mogą przyjmować tylko obiekty; sprawdź obsługę symboli w środowisku docelowym.
Sam wpis w WeakSet nie utrzymuje wartości przy życiu. Gdy wartość nie jest już osiągalna przez silne odwołania, mechanizm odśmiecania pamięci może ją usunąć; nie zakładaj, kiedy to nastąpi. WeakSet nie pozwala iterować po elementach i nie ma właściwości size. Nadaje się do oznaczania już przetworzonych obiektów; jeśli potrzebujesz iteracji lub liczby elementów, użyj Set, pamiętając, że przechowuje on wartości przez silne odwołania.
Przykłady
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Wynik
true true false true false false false false true
Dwukrotne dodanie `task` nadal zwraca `seen`. `lookalike` ma tę samą zawartość, ale nie należy do zbioru. Tylko pierwsze usunięcie `task` zwraca `true`. Końcowe `true` potwierdza typ błędu po `add(1)`; wynik nie zależy od działania mechanizmu odśmiecania pamięci.
Powiązane lekcje
- JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3