Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakMap.prototype.get() — odczyt wartości według klucza

Użyj `weakMap.get(key)`, aby odczytać zapisaną wartość bez zmiany mapy. Metoda nie odróżnia braku wpisu od zapisanej wartości `undefined`; do tego służy `has()`.

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

Składnia

weakMap.get(key)

WeakMap.prototype.get to metoda instancji, którą wywołujesz jako weakMap.get(key). Zwraca wartość przypisaną do klucza bez dodawania ani zmieniania wpisu. Jeśli zapisaną wartością jest obiekt, otrzymasz ten sam obiekt, a nie jego kopię.

Klucze są porównywane według tożsamości: dwa osobne obiekty o identycznych właściwościach to różne klucze. ECMAScript 2024 dopuszcza jako klucze obiekty i niezarejestrowane symbole, np. utworzone przez Symbol(), ale nie przez Symbol.for(). Starsze środowiska wykonawcze mogą nie obsługiwać kluczy symbolicznych.

get() zwraca undefined, gdy wpisu nie ma, klucz jest niedozwolony (np. jest napisem) lub zapisana wartość to undefined. Użyj weakMap.has(key), aby odróżnić zapisane undefined (true) od braku wpisu (false). W przeciwieństwie do get(), set() zgłasza TypeError dla niedozwolonego klucza. Samo get() zgłasza TypeError, jeśli this nie jest instancją WeakMap, np. gdy wywołasz metodę zapisaną w zmiennej bez powiązania z mapą.

WeakMap nie utrzymuje klucza przy życiu samym faktem, że go przechowuje. Nie można wyliczyć jego kluczy ani przewidzieć momentu, w którym mechanizm odśmiecania pamięci usunie nieosiągalny klucz.

Przykłady

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

  weakMap.set(key, 42);
  weakMap.set(pending, undefined);

  console.log(weakMap.get(key));
  console.log(weakMap.get(lookalike));
  console.log(weakMap.get(pending));
  console.log(weakMap.has(pending));
  console.log(weakMap.has(lookalike));
  console.log(weakMap.get("id"));
}

Wynik

42
undefined
undefined
true
false
undefined

`lookalike` ma te same właściwości co `key`, ale jest innym obiektem. Zarówno dla `lookalike`, jak i dla `pending` metoda `get()` zwraca `undefined`, lecz `has()` zwraca `true` tylko dla `pending`. Odczyt z kluczem tekstowym `"id"` zwraca `undefined` bez wyjątku.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 37 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 4 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 10 · Średniozaawansowany · Wersja: 3

Źródła