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

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

Sources