CKTIS / JavaScript
Map.prototype.entries : itérateur de paires clé–valeur
La méthode entries renvoie un itérateur vivant de paires [key, value] dans l’ordre d’insertion et constitue l’itération par défaut d’une Map.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.entries()map.entries() crée un nouvel objet itérateur de Map. Chaque next() réussi renvoie un nouveau tableau à deux éléments [key, value] ; modifier ce tableau ne change pas l’entrée de la Map, même si les objets contenus restent les mêmes références. map[Symbol.iterator] est la même fonction que map.entries ; for...of et le spread reçoivent donc des paires par défaut.
L’itérateur est paresseux, pas une capture. Il conserve l’ordre d’insertion, saute les entrées supprimées avant leur visite et peut voir celles ajoutées avant d’atteindre la fin ; la mise à jour d’une clé pas encore visitée fournit la nouvelle valeur. Après que next() a renvoyé done: true, des ajouts ultérieurs ne relancent pas cet itérateur.
La méthode n’accepte aucun argument significatif et exige un receveur doté des données internes de Map ; un objet ordinaire, un Set ou un Proxy non géré lève TypeError. Elle est standard depuis ECMAScript 2015. Si seuls les clés ou les valeurs sont nécessaires, keys() ou values() évitent les tableaux de paires.
Exemples
const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));
map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);
map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);Résultat
["a",1] 1 ["c",3] false true true true