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

CKTIS / JavaScript

Itérateurs et générateurs

Un itérateur expose des résultats successifs avec next(), tandis qu’un objet itérable fournit un itérateur via Symbol.iterator. Un générateur facilite la mise en œuvre de ces deux mécanismes avec function* et yield.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }

Un itérateur est un objet doté d’une méthode next() qui renvoie un objet résultat, et non l’élément lui-même. Un objet itérable expose une méthode [Symbol.iterator]() qui renvoie un itérateur. Avoir uniquement next() ne suffit donc pas pour utiliser un objet dans for...of.

Le résultat de l’itérateur — iterator result value/done — est décrit par les champs value et done. Avec done: false, value contient l’élément suivant. Avec done: true, l’itération est terminée et value peut contenir une valeur de retour finale. Si done est absent, il est considéré comme égal à false ; si value est absent, le résultat est undefined. Ne détectez pas la fin en comparant value à undefined : cette valeur peut être un élément valide.

L’appel d’une fonction function* crée un générateur qui est à la fois un itérateur et un objet itérable. next() reprend l’exécution, yield fournit un élément et suspend la fonction, et return la termine. for...of et la syntaxe de décomposition ... ignorent la valeur du résultat lorsque done: true.

Un générateur conserve son état : le réutiliser ne redémarre pas l’itération. Rappelez la fonction génératrice pour effectuer un nouveau parcours. L’exemple distingue les éléments issus de yield de la valeur finale issue de return.

Exemples

function* numbers() {
  yield 10;
  yield 20;
  return 99;
}

const iterator = numbers();
for (let i = 0; i < 4; i++) {
  const { value, done } = iterator.next();
  console.log(`${String(value)} | ${done}`);
}
console.log([...numbers()].join(", "));

Résultat

10 | false
20 | false
99 | true
undefined | true
10, 20

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources