Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

yield — sospendere un generatore

L’espressione `yield` sospende un generatore ed espone un valore a chi lo consuma. Una successiva chiamata a `next(value)` riprende l’esecuzione e fornisce un valore all’espressione sospesa; `yield*` delega l’iterazione.

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

Sintassi

yield;
yield expression;
yield* iterable;

yield expression sospende un generatore preservandone lo stato. In un generatore sincrono, next() restituisce quindi { value, done: false }. Un yield senza operando espone undefined. La chiamata a una funzione function* crea un generatore; il suo corpo inizia a essere eseguito solo al primo next().

L’argomento di una successiva chiamata a next(value) diventa il risultato dell’espressione yield sospesa. L’argomento del primo next() viene ignorato. Quando il generatore termina con return value, il risultato è { value, done: true }. Se return value fa uscire l’esecuzione da un blocco try e nel blocco finally corrispondente viene eseguito un yield, il generatore può sospendersi di nuovo e produrre un risultato con done: false prima che il ritorno in sospeso si completi.

yield* iterable delega l’iterazione e inoltra i valori generati; il risultato dell’espressione è il valore finale dell’iteratore delegato. Le espressioni yield sono consentite nei corpi dei generatori sincroni e asincroni, ma non nei loro parametri né in funzioni ordinarie o arrow annidate. Nei generatori asincroni, next() restituisce una promise con un risultato di iterazione.

Non inserire un’interruzione di riga tra yield e il suo operando o *: può cambiare l’analisi sintattica o causare un errore di sintassi. yield non può essere un identificatore nel codice strict o nei contesti grammaticali riservati ai generatori; alcuni altri contesti non-strict lo consentono.

Esempi

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));
}

Risultato

{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti