Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Dichiarazione di funzione generatrice e metodo generatore

Entrambe le forme definiscono funzioni generatrici sincrone. La dichiarazione introduce un nome nel proprio ambito, mentre il metodo appartiene a un oggetto o a una classe.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

function* sequence(start) { yield start; }
const object = { *values() { yield this.start; } };
class Series { *values() { yield this.start; } }

Una dichiarazione come function* sequence(start) { ... } introduce il nome sequence nel proprio ambito. La forma *values() { ... } definisce un metodo in un oggetto o in una classe: l’asterisco precede il nome del metodo e la parola chiave function non compare. Con la chiamata counter.values(), nel metodo this vale counter.

Ogni chiamata restituisce un nuovo generatore sincrono, che è sia un iteratore sia un oggetto iterabile. Le istruzioni del corpo iniziano a essere eseguite solo alla prima chiamata a next(). yield value sospende l’esecuzione, conserva lo stato locale e produce un risultato della forma { value, done: false }. La chiamata successiva a next() riprende l’esecuzione. Usare new con una delle due funzioni genera un TypeError.

Se next() raggiunge return value, il risultato è { value, done: true }. Un ciclo for...of e la sintassi di espansione ... raccolgono i valori prodotti da yield, ma non il valore finale di return. Una volta terminato il generatore, le successive chiamate a next() restituiscono { value: undefined, done: true }. Per ricominciare, richiama la funzione o il metodo.

Esempi

{
  function* sequence(start) {
    yield start;
    return start + 1;
  }

  const counter = {
    start: 7,
    *values() {
      yield this.start;
    },
  };

  const steps = sequence(3);
  for (let i = 0; i < 3; i++) {
    const { value, done } = steps.next();
    console.log(`${value} ${done}`);
  }
  console.log(JSON.stringify([...counter.values()]));
}

Risultato

3 false
4 true
undefined true
[7]

Le chiamate a `next()` mostrano il `3` prodotto da `yield`, il `4` restituito da `return` e infine lo stato di esaurimento. L’espansione del generatore ottenuto da `counter.values()` produce `[7]` perché il metodo legge `counter.start` tramite `this`.

Lezioni correlate

  • JavaScript · Lezione 8 · Avanzato · Versione: 4

Fonti