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 set()

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 set() des instances de Map ajoute une nouvelle entrée avec une clé et une valeur définies à cette Map, ou met à jour une entrée existante si la clé existe déjà.

Exemple interactif

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

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

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

Syntaxe

js
set(key, value)

Paramètres

key

La clé de l'entrée à ajouter ou à modifier dans l'objet Map. Peut être n'importe quelle valeur. Les clés des objets sont comparées par référence, et pas par valeur.

value

La valeur de l'entrée à ajouter ou à modifier dans l'objet Map. Peut être n'importe quelle valeur.

Valeur de retour

L'objet Map concerné.

Exemples

Utiliser la méthode set()

js
const maMap = new Map();

// On ajoute de nouveaux éléments à l'objet map
maMap.set("truc", "toto");
maMap.set(1, "bidule");

// On met à jour un élément
maMap.set("truc", "fuuu");

Utiliser la méthode set() avec un enchaînement

La méthode set() renvoie le même objet Map et on peut donc la chaîner pour des opérations successives :

js
// Ajouter de nouveaux éléments au tableau associatif avec chaînage.
maMap.set("truc", "toto").set(1, "tototruc").set(2, "bidule");

Spécifications

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

Compatibilité des navigateurs

Voir aussi