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

CKTIS / JavaScript

yield — suspendre un générateur

L’expression `yield` suspend un générateur et expose une valeur à son consommateur. Un appel ultérieur à `next(value)` reprend l’exécution et fournit une valeur à l’expression suspendue ; `yield*` délègue l’itération.

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

yield;
yield expression;
yield* iterable;

yield expression suspend un générateur tout en préservant son état. Dans un générateur synchrone, next() renvoie alors { value, done: false }. Un yield sans opérande expose undefined. L’appel d’une fonction function* crée un générateur ; son corps ne commence à s’exécuter qu’au premier next().

L’argument d’un appel ultérieur à next(value) devient le résultat de l’expression yield suspendue. L’argument du premier next() est ignoré. Lorsque le générateur se termine par return value, le résultat est { value, done: true }. Si return value fait sortir l’exécution d’un bloc try et que le bloc finally correspondant exécute un yield, le générateur peut se suspendre à nouveau et produire un résultat avec done: false avant que le retour en attente s’achève.

yield* iterable délègue l’itération et transmet les valeurs produites ; le résultat de l’expression est la valeur finale de l’itérateur délégué. Les expressions yield sont autorisées dans les corps des générateurs synchrones et asynchrones, mais pas dans leurs paramètres ni dans des fonctions ordinaires ou fléchées imbriquées. Dans les générateurs asynchrones, next() renvoie une promesse contenant un résultat d’itération.

Ne placez pas de saut de ligne entre yield et son opérande ou * : cela peut modifier l’analyse syntaxique ou provoquer une erreur de syntaxe. yield ne peut pas être un identifiant en code strict ni dans les contextes grammaticaux réservés aux générateurs ; certains autres contextes non stricts l’autorisent.

Exemples

function* exchange() {
  const received = yield 10;
  yield received + 1;
  return 99;
}

const iterator = exchange();
for (const result of [iterator.next(), iterator.next(20), iterator.next()]) {
  console.log(JSON.stringify(result));
}

Résultat

{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":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.

Sources