CKTIS / JavaScript
Fonction génératrice : function*
Une fonction génératrice crée un itérateur dont l’exécution peut être mise en pause à yield puis reprise avec next(). Elle calcule les valeurs à la demande tout en conservant l’état local entre les étapes successives.
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
function* name(parameters) {
yield value;
return finalValue;
}La déclaration function* name(parameters) { ... } définit une fonction génératrice. Son appel crée un nouvel objet Generator, mais n’exécute pas encore le corps de la fonction. Chaque objet possède son propre état d’exécution ; le premier next() démarre le corps, et yield value fournit une valeur puis met l’exécution en pause.
Un autre appel à next() reprend l’exécution après yield, en conservant les variables locales. Le résultat comporte les champs value et done : yield produit done: false, tandis que return finalValue termine le générateur avec done: true. Sans return explicite, la valeur finale est undefined. Après la fin, les appels suivants à next() renvoient value: undefined et done: true.
Un objet générateur est à la fois un itérateur et un objet itérable. for...of et la syntaxe de décomposition (...) dans les littéraux de tableau et les listes d’arguments des appels de fonction récupèrent les valeurs de yield, mais excluent la valeur finale de return. Dans un littéral d’objet, cette syntaxe ne fait pas avancer le générateur : elle copie les propriétés propres et énumérables de l’objet générateur. Un générateur épuisé ne peut pas redémarrer ; appelez plutôt la fonction à nouveau. Un argument de next(value) devient le résultat de l’expression yield mise en pause ; l’argument du premier next() est ignoré.
Vous pouvez aussi définir un générateur avec une expression telle que const make = function* () { yield 1; };, où le nom de la fonction est facultatif. Il n’existe pas de syntaxe de fonction fléchée génératrice. MDN classe function* parmi les fonctionnalités largement disponibles dans les navigateurs depuis septembre 2016 ; vérifiez séparément la prise en charge du navigateur cible.
Exemples
function* steps() {
yield 10;
yield 20;
return 30;
}
const iterator = steps();
for (let i = 0; i < 4; i++) {
const { value, done } = iterator.next();
console.log(`${value} | ${done}`);
}
console.log([...steps()].join(", "));Résultat
10 | false 20 | false 30 | 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.