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

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

Sources