CKTIS / JavaScript
WeakMap.get() — odczyt wartości po kluczu
Metoda `weakMap.get(key)` zwraca wartość przypisaną do klucza. Użyj `has(key)`, aby odróżnić brak wpisu od zapisanej wartości `undefined`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
weakMap.get(key)WeakMap.get to skrótowa nazwa metody instancji WeakMap.prototype.get, a nie metody statycznej konstruktora. Wywołanie weakMap.get(key) zwraca zapisaną wartość bez zmieniania mapy. Klucze są porównywane według tożsamości: dwa osobno utworzone obiekty o tych samych właściwościach to różne klucze. Jeśli zapisana wartość jest obiektem, metoda zwraca ten sam obiekt, nie jego kopię.
Brak wpisu i wpis z wartością undefined dają ten sam wynik: undefined. Użyj weakMap.has(key), aby je rozróżnić: metoda zwraca true, gdy wpis istnieje, nawet jeśli jego wartością jest undefined.
ECMAScript 2024 dopuszcza jako klucze obiekty, w tym funkcje, oraz niezarejestrowane symbole, np. Symbol('id'). Starsze silniki mogą obsługiwać WeakMap, ale nie klucze będące symbolami. Na instancji WeakMap metoda get() dla niedozwolonego klucza, np. napisu lub symbolu z Symbol.for(), zwraca undefined, podczas gdy set() zgłasza TypeError. Sama metoda get() zgłasza TypeError, jeśli jej this nie jest instancją WeakMap, np. gdy wywołasz odłączoną metodę bez powiązania jej z instancją.
Sama mapa nie utrzymuje klucza przy życiu. Gdy klucz przestaje być osiągalny, jego wpis może zostać usunięty podczas odśmiecania pamięci. Nie można wyliczyć kluczy ani polegać na konkretnym momencie usunięcia wpisu.
Przykłady
const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };
weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));
weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));Wynik
42 undefined undefined true undefined
`key` i `otherKey` to różne obiekty, mimo że mają takie same właściwości. Dwa odczyty dla `otherKey` zwracają `undefined`: najpierw nie ma wpisu, a potem istnieje wpis o wartości `undefined`, co potwierdza `has()`. Ostatni odczyt używa niedozwolonego klucza.
Powiązane lekcje
- JavaScript · Lekcja 18 · Podstawowy · Wersja: 4