База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Map.prototype.get: четене на стойност по ключ

Методът get връща стойността, съхранена под съвпадащ ключ на Map, или undefined, ако такъв запис няма.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

map.get(key)

map.get(key) търси ключа без преобразуване на типа и не променя Map или реда. За намерен ключ връща точно съхранената стойност, включително същата препратка към обект; за липсващ ключ undefined.

Ключовете използват SameValueZero: NaN съвпада с NaN и -0 с +0; обектите само по идентичност. Съществуващ запис може умишлено да съдържа undefined, затова get не го различава от липса—използвайте map.has(key).

Получателят трябва да има вътрешни данни на Map; обект, Set или необработен Proxy като this хвърля TypeError. Стандартен от ECMAScript 2015. get не стартира фабрика и не създава запис; get-or-create трябва изрично да използва has/set и да отчита undefined.

Примери

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);
}

Резултат

true
undefined
not a number
undefined true
undefined false
true

Източници