CKTIS / JavaScript
Map — une collection clé-valeur
Map stocke des clés uniques de tout type avec les valeurs qui leur sont associées. Elle permet de lire et de supprimer des entrées, de vérifier la présence d’une clé et de parcourir les éléments dans leur ordre d’insertion.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Map()
new Map(iterable)
map.set(key, value)
map.get(key)
map.has(key)
map.delete(key)
map.clear()
map.size
for (const [key, value] of map) { /* ... */ }Map est une collection intégrée de paires clé-valeur. Les clés comme les valeurs peuvent être n’importe quelle valeur JavaScript. Créez une map vide avec new Map() ou transmettez au constructeur un objet itérable contenant des paires [key, value]. Un appel sans new déclenche une TypeError.
set(key, value) ajoute ou met à jour une entrée et renvoie la map. get(key) lit sa valeur ; si la clé est absente, le résultat est undefined. Comme une valeur stockée peut elle aussi être undefined, vérifiez la présence avec has(key). La propriété size indique le nombre d’entrées, delete(key) indique si une entrée a été supprimée, et clear() supprime toutes les entrées.
La comparaison des clés suit SameValueZero : NaN correspond à NaN, et +0 et -0 sont la même clé. Les objets sont comparés par identité, et non par leur contenu. Deux objets { id: 1 } créés séparément sont donc des clés différentes.
L’itération avec for...of produit les paires dans l’ordre d’insertion des clés ; keys(), values() et entries() renvoient les itérateurs correspondants. La mise à jour d’une valeur ne déplace pas son entrée, mais sa suppression puis sa réinsertion la place à la fin. Pour ajouter des entrées, utilisez set(key, value), et non map[key] = value. Une affectation avec des crochets vise une propriété de l’objet, et non une entrée de la map. Par exemple, sur une instance de Map non modifiée, map["size"] = value déclenche une TypeError en mode strict et est ignorée sinon, car la propriété héritée size a un accesseur en lecture, mais pas en écriture.
Exemples
const key = { id: 1 };
const map = new Map([["first", 1], [key, 2]]);
map.set("first", 3);
map.set(NaN, 4);
map.set(NaN, 5);
console.log(map.size);
console.log(map.get(key));
console.log(map.has({ id: 1 }));
console.log(map.get(NaN));
console.log(JSON.stringify([...map.values()]));Résultat
3 2 false 5 [3,2,5]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.