Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakMap: sprawdzanie, odczyt i zapis za pomocą has(), get() i set()

Sprawdź, czy klucz istnieje, odczytaj jego wartość lub ją zmień. Dowiedz się, jak odróżnić brak wpisu od zapisanego `undefined` i jakie klucze przyjmuje `WeakMap`.

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

Składnia

weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)

WeakMap.prototype.has/get/set to skrót oznaczający trzy metody instancji WeakMap. Klucze porównuje się według tożsamości: dwa osobne obiekty o identycznych właściwościach to różne klucze.

  • has(key) zwraca true, jeśli wpis istnieje, a w przeciwnym razie false.
  • get(key) zwraca zapisaną wartość albo undefined, jeśli wpisu nie ma. Użyj has(key), aby odróżnić brak wpisu od zapisanego undefined.
  • set(key, value) dodaje wpis lub zastępuje wartość pod tym samym kluczem. Przyjmuje dowolną wartość JavaScript i zwraca tę samą instancję WeakMap, co pozwala łączyć wywołania.

ECMAScript 2024 dopuszcza jako klucze obiekty (w tym funkcje) oraz niezarejestrowane symbole, np. Symbol() i Symbol.iterator, ale nie symbole z Symbol.for(). Starsze środowiska mogą obsługiwać tylko klucze obiektowe; sprawdź obsługę symboli w docelowym środowisku.

Dla niedozwolonego klucza, np. 1, has() zwraca false, get() zwraca undefined, a set() zgłasza TypeError. Wszystkie trzy metody najpierw sprawdzają this: wywołanie z this, które nie jest rzeczywistą instancją WeakMap, zgłasza TypeError niezależnie od klucza.

WeakMap nadaje się do przechowywania metadanych obiektu bez utrzymywania samego klucza przy życiu, nawet gdy zapisana wartość odwołuje się do klucza. Moment odzyskania pamięci nie jest gwarantowany. WeakMap nie pozwala iterować po kluczach ani nie udostępnia size; użyj Map, jeśli potrzebujesz tych możliwości lub kluczy tekstowych czy liczbowych.

Przykłady

{
  const map = new WeakMap();
  const key = { id: 1 };
  const lookalike = { id: 1 };

  map.set(key, undefined);
  console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
  console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);

  const result = map.set(key, 42);
  console.log(`updated: ${map.get(key)}, same map: ${result === map}`);

  console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
  try {
    map.set(1, 42);
  } catch (error) {
    console.log(error.name);
  }
}

Wynik

stored: true, undefined
missing: false, undefined
updated: 42, same map: true
invalid key: false, undefined
TypeError

`key` i `lookalike` mają takie samo `id`, ale są różnymi obiektami. Oba odczyty dają początkowo `undefined`; tylko `has(key)` zwraca `true`. Drugi zapis zastępuje wartość liczbą `42` i zwraca tę samą mapę. Klucz `1` pokazuje różnicę między odczytem a zapisem dla niedozwolonego klucza.

Powiązane lekcje

  • JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4

Źródła