Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Map.prototype.get: odczyt wartości po kluczu

Metoda get zwraca wartość zapisaną pod pasującym kluczem Map albo undefined, gdy takiego wpisu nie ma.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

map.get(key)

map.get(key) wyszukuje klucz bez konwersji typu i nie zmienia Map ani kolejności wpisów. Dla znalezionego klucza zwraca dokładnie zapisaną wartość, w tym tę samą referencję do obiektu; dla brakującego klucza zwraca undefined.

Klucze używają SameValueZero: NaN pasuje do NaN, a -0 do +0; obiekty pasują tylko przez tożsamość referencji. Ponieważ istniejący wpis może celowo zawierać undefined, sam wynik get nie rozróżnia go od braku wpisu — w takim przypadku użyj map.has(key).

Odbiorca musi mieć wewnętrzne dane Map; zwykły obiekt, Set albo nieobsłużony Proxy jako this powoduje TypeError. Metoda jest standardowa od ECMAScript 2015. get nie uruchamia fabryki wartości ani nie tworzy wpisu, więc wzorzec get-or-create musi jawnie użyć has/set i uwzględnić wartość undefined.

Przykłady

const key = { id: 7 };
const stored = { enabled: true };
const map = new Map([[key, stored], ["empty", undefined], [NaN, "not a number"]]);
console.log(map.get(key) === stored);
console.log(map.get({ id: 7 }));
console.log(map.get(NaN));
console.log(map.get("empty"), map.has("empty"));
console.log(map.get("missing"), map.has("missing"));

try {
  Map.prototype.get.call({}, "x");
} catch (error) {
  console.log(error instanceof TypeError);
}

Wynik

true
undefined
not a number
undefined true
undefined false
true

Źródła