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