Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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) // boolean

WeakSet.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

Źródła