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

CKTIS / JavaScript

Map.prototype.set : écrire une entrée

La méthode set ajoute ou met à jour une paire clé–valeur dans une Map et renvoie cette même Map pour permettre le chaînage.

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

Syntaxe

map.set(key, value)

map.set(key, value) stocke sans conversion et renvoie la Map receveuse. Une nouvelle clé est ajoutée à la fin de l’ordre d’insertion. Mettre à jour une clé remplace sa valeur sans changer size ni sa position ; seul delete suivi de set crée une nouvelle position finale.

Les clés suivent SameValueZero : NaN correspond à NaN et -0 est normalisé en +0. Clés et valeurs objets gardent les mêmes références sans clonage. Le retour permet map.set(a, 1).set(b, 2).

Le receveur doit avoir les données internes de Map ; objet, Set ou Proxy non géré lève TypeError. Standard depuis ECMAScript 2015. Dans un get-or-create, une valeur existante peut être undefined ; get seul ne teste donc pas toujours la présence.

Exemples

const map = new Map();
console.log(map.set("a", 1) === map);
map.set("b", 2).set("a", 3);
console.log(map.size, [...map.keys()].join(","), map.get("a"));
map.delete("a");
map.set("a", 4);
console.log([...map.keys()].join(","));
const key = {};
const value = {};
map.set(key, value);
console.log(map.get(key) === value);
map.set(NaN, 1).set(NaN, 2).set(-0, "zero");
console.log(map.get(NaN), map.get(+0));
try { Map.prototype.set.call({}, "x", 1); } catch (error) { console.log(error instanceof TypeError); }

Résultat

true
2 a,b 3
b,a
true
2 zero
true

Sources