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