CKTIS / JavaScript
Map.prototype.values : itérateur de valeurs
La méthode values renvoie un itérateur vivant des valeurs de Map dans l’ordre d’insertion de leurs clés.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.values()map.values() crée un nouvel itérateur de Map. Chaque next() réussi renvoie la valeur de l’entrée suivante. Les objets restent les mêmes références et des valeurs égales sous plusieurs clés sont renvoyées séparément ; aucune déduplication.
L’itérateur est paresseux, pas une capture. Une entrée supprimée avant sa visite est sautée, une mise à jour avant visite fournit la nouvelle valeur et un ajout avant la fin peut être vu. Mettre à jour une clé déjà visitée ne la répète pas. Après done: true, aucun ajout ne relance l’itérateur.
La méthode n’accepte aucun argument significatif et exige les données internes de Map ; objet, Set ou Proxy non géré lève TypeError. Standard depuis ECMAScript 2015. Pour conserver le lien avec les clés, utilisez entries().
Exemples
const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }Résultat
true 20 4 true true 1,1 true