Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Map.prototype.get : lire une valeur par clé

La méthode get renvoie la valeur stockée sous une clé Map correspondante, ou undefined si aucune entrée n’existe.

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

Syntaxe

map.get(key)

map.get(key) recherche une clé sans conversion de type et ne modifie ni la Map ni son ordre. Pour une clé trouvée, elle renvoie exactement la valeur stockée, y compris la même référence d’objet ; sinon elle renvoie undefined.

Les clés suivent SameValueZero : NaN correspond à NaN et -0 à +0 ; les objets ne correspondent que par identité. Une entrée peut contenir volontairement undefined ; le seul résultat de get ne la distingue donc pas d’une absence—utilisez map.has(key).

Le receveur doit posséder les données internes de Map ; un objet ordinaire, un Set ou un Proxy non géré comme this lève TypeError. Standard depuis ECMAScript 2015. get n’exécute aucune fabrique et ne crée pas d’entrée ; un get-or-create doit utiliser explicitement has/set et gérer undefined.

Exemples

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

Résultat

true
undefined
not a number
undefined true
undefined false
true

Sources