Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Map : méthode get()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode get() des instances de Map retourne la valeur correspondant à la clé dans cette Map, ou undefined s'il n'y en a pas. Les valeurs des objets sont retournées sous la même référence que celle qui a été initialement stockée, et non sous forme de copie, de sorte que les modifications apportées à l'objet retourné seront reflétées partout où cette référence est utilisée, y compris à l'intérieur de la Map.

Exemple interactif

const map = new Map();
map.set("toto", "truc");

console.log(map.get("toto"));
// Sortie attendue : "truc"

console.log(map.get("tata"));
// Sortie attendue : undefined

Syntaxe

js
get(key)

Paramètres

key

La clé de la valeur à retourner depuis l'objet Map. Les clés des objets sont comparées par référence, et pas par valeur.

Valeur de retour

La valeur associée à la clé définie dans l'objet Map. Si la clé n'est pas trouvée, undefined est retournée.

Exemples

Utiliser la méthode get()

js
const maMap = new Map();
maMap.set("truc", "toto");

maMap.get("truc"); // Retourne "toto".
maMap.get("machin"); // Retourne undefined.

Utiliser get() pour récupérer une référence à un objet

js
const arr = [];
const maMap = new Map();
maMap.set("toto", arr);

maMap.get("toto").push("truc");

console.log(arr); // ["truc"]
console.log(maMap.get("toto")); // ["truc"]

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-map.prototype.get

Compatibilité des navigateurs

Voir aussi