CKTIS / JavaScript
Itérateurs de Map : next(), value et done
Parcourez un itérateur de Map avec `next()` et utilisez `done` pour distinguer une valeur `undefined` enregistrée de la fin de l’itération.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Appelez iterator.next() pour avancer d’un pas. Cette méthode appartient à l’itérateur, pas à la Map, et renvoie un objet résultat avec les propriétés value et done. Lire result.value ne fait pas avancer l’itérateur, contrairement à un nouvel appel à next(). Conservez le résultat si vous avez besoin des deux propriétés du même pas. Appeler la méthode next séparément, sans le bon this, déclenche une TypeError.
map.keys() produit les clés et map.values() les valeurs enregistrées. À chaque pas qui produit un élément, map.entries() et map[Symbol.iterator]() fournissent un nouveau tableau [key, value] à deux éléments dans result.value. Les trois types d’itérateurs parcourent les entrées dans l’ordre d’insertion. Vérifiez done, et non value : done: false indique qu’un élément a été produit, même si value vaut undefined. Un itérateur de Map épuisé renvoie { value: undefined, done: true }.
L’itérateur n’est pas un instantané : il peut voir les entrées ajoutées avant son épuisement, mais il ne reprend jamais après avoir renvoyé done: true. Créez un nouvel itérateur pour repartir du début. C’est le comportement de la Map intégrée dans ECMAScript 2024 ; la prise en charge varie selon l’environnement d’exécution.
Exemples
{
const map = new Map([["a", undefined], ["b", 7]]);
const iterator = map.values();
function logStep({ value, done }) {
console.log(`done=${done}, value=${value}`);
}
logStep(iterator.next());
logStep(iterator.next());
logStep(iterator.next());
map.set("c", 9);
logStep(iterator.next());
console.log(JSON.stringify(map.entries().next().value));
}Résultat
done=false, value=undefined done=false, value=7 done=true, value=undefined done=true, value=undefined ["a",null]
Le premier pas produit un `undefined` enregistré ; le troisième signale la fin. L’ajout de `"c"` ne relance pas l’itérateur. Un nouvel itérateur d’entrées commence à `"a"` ; sur la dernière ligne, `JSON.stringify()` représente l’élément `undefined` du tableau par `null`, sans modifier la Map.
Leçons associées
- JavaScript · Leçon 7 · Avancé · Version : 4
Sources
- ECMAScript 2024 Language Specification — Map Iterator Objects
- ECMAScript Language Specification — Properties of the Map Prototype Object
- ECMAScript Language Specification — Map Iterator Objects
- ECMAScript 2024 Language Specification — GeneratorResume
- ECMAScript 2024 Language Specification — GeneratorValidate