Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakSet: sprawdzanie i dodawanie elementów za pomocą has() i add()

Użyj `has()`, aby sprawdzić, czy dana wartość należy do `WeakSet`, a `add()`, aby ją dodać. Liczy się tożsamość wartości, a sama kolekcja nie utrzymuje jej przy życiu.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const seen = new WeakSet();
seen.has(value);
seen.add(value);

WeakSet.prototype.has i WeakSet.prototype.add to dwie metody instancji. seen.has(value) zwraca true, jeśli wartość należy do kolekcji, w przeciwnym razie false. seen.add(value) dodaje wartość, jeśli jeszcze jej nie ma, i zwraca tę samą instancję WeakSet. Ponowne dodanie nie tworzy duplikatu, a zwracana instancja pozwala łączyć wywołania add().

Porównywana jest tożsamość, nie zawartość: dwie referencje do tego samego obiektu wskazują ten sam element, ale dwa osobne obiekty o identycznych właściwościach nie są tym samym elementem. W ECMAScript 2024 WeakSet przyjmuje obiekty (w tym funkcje) i niezarejestrowane symbole, np. utworzone przez Symbol(). Dla symbolu z Symbol.for(), liczby, napisu lub null metoda has() zwraca false, a add() zgłasza TypeError. Obie metody zgłaszają też TypeError, jeśli this nie jest instancją WeakSet, np. przy wywołaniu odłączonej metody bez powiązania z instancją.

Samo członkostwo nie zapobiega usunięciu wartości przez mechanizm odśmiecania pamięci. Nie można przewidzieć momentu odzyskania pamięci. WeakSet nie udostępnia size ani możliwości iteracji po elementach. Nadaje się do oznaczania już przetworzonych obiektów, gdy nie trzeba ich potem wypisywać. Wybierz Set, jeśli potrzebujesz iteracji, rozmiaru lub przechowywania wartości takich jak liczby i napisy.

Obsługa symboli może zależeć od środowiska wykonawczego. Jeśli na niej polegasz, sprawdź add() z wartością utworzoną przez Symbol() w środowisku docelowym; sama obecność WeakSet nie wystarcza.

Przykłady

{
  const seen = new WeakSet();
  const item = { id: 1 };
  const alias = item;

  console.log(seen.has(item));
  console.log(seen.add(item).add(item) === seen);
  console.log(seen.has(alias));
  console.log(seen.has({ id: 1 }));
  console.log(seen.has(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error.name);
  }
}

Wynik

false
true
true
false
false
TypeError

Pierwsze `has()` zwraca `false`. Dwa wywołania `add()` można połączyć, bo metoda zwraca tę samą instancję. `alias` wskazuje dodany obiekt, a nowy obiekt z tym samym `id` nie jest jego odpowiednikiem pod względem tożsamości. Dla liczby `1` sprawdzenie zwraca `false`, a próba dodania zgłasza przechwycony `TypeError`.

Powiązane lekcje

  • JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 43 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 40 · Średniozaawansowany · Wersja: 3

Źródła