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

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