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 Large disponibilité

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

Spécification
ECMAScript® 2027 Language Specification>
# sec-map.prototype.get>

Compatibilité des navigateurs

Voir aussi