CKTIS / JavaScript
Generator.prototype.next() — reprendre un générateur
La méthode `next()` démarre ou reprend un générateur synchrone et renvoie un objet résultat d’itération. Son argument facultatif devient le résultat d’une expression `yield` simple suspendue ; l’argument du premier appel est ignoré.
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
generator.next()
generator.next(value)Generator.prototype.next est la méthode utilisée sous la forme generator.next(). L’appel d’une fonction function* crée un générateur sans exécuter son corps. Le premier next() démarre l’exécution ; les appels suivants la reprennent jusqu’à la prochaine suspension ou jusqu’à la fin.
Avec un yield simple, le résultat contient la valeur produite dans value et indique done: false. Quand le générateur se termine normalement, le résultat contient done: true et value contient la valeur de return, ou undefined si aucune valeur n’a été fournie. Les appels effectués après la fin renvoient { value: undefined, done: true }.
Lors d’une délégation avec yield*, si la propriété done du résultat renvoyé par le next() de l’itérateur délégué vaut false après conversion en booléen, le next() du générateur externe renvoie ce même objet sans le modifier. Par exemple, si l’itérateur délégué renvoie {}, l’absence de done est interprétée comme false et l’objet renvoyé ne contient toujours ni value ni done.
Quand le générateur est suspendu sur un yield simple, l’argument de next(value) devient le résultat de cette expression. Dans const input = yield "ready", la première étape fournit "ready", puis l’appel suivant next(7) affecte 7 à input. L’argument du premier appel est ignoré, car le générateur n’est pas encore suspendu sur un yield.
Rappeler next() sur un générateur en cours d’exécution provoque une TypeError. Chaque instance ne parcourt sa séquence qu’une seule fois ; rappelle la fonction génératrice pour recommencer.
Exemples
function* exchange() {
const input = yield "ready";
return input * 2;
}
const generator = exchange();
function print(result) {
console.log(String(result.value) + " | " + result.done);
}
print(generator.next(999));
print(generator.next(7));
print(generator.next());Résultat
ready | false 14 | true undefined | true
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.