Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Funzione generatrice: function*

Una funzione generatrice crea un iteratore la cui esecuzione può essere sospesa in corrispondenza di yield e ripresa tramite next(). Calcola i valori su richiesta e conserva lo stato locale tra un passaggio e il successivo.

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

function* name(parameters) {
  yield value;
  return finalValue;
}

La dichiarazione function* name(parameters) { ... } definisce una funzione generatrice. Chiamandola si crea un nuovo oggetto Generator, ma il corpo della funzione non viene ancora eseguito. Ogni oggetto ha un proprio stato di esecuzione; il primo next() avvia il corpo e yield value fornisce un valore e sospende l’esecuzione.

Un altro next() riprende l’esecuzione dopo yield, conservando le variabili locali. Il risultato contiene i campi value e done: yield produce done: false, mentre return finalValue termina il generatore con done: true. Senza un return esplicito, il valore finale è undefined. Dopo la conclusione, le chiamate successive a next() restituiscono value: undefined e done: true.

Un oggetto generatore è sia un iteratore sia un oggetto iterabile. for...of e la sintassi spread (...) nei letterali di array e negli elenchi di argomenti delle chiamate di funzione consumano i valori di yield, ma escludono il valore finale di return. Nei letterali oggetto, la sintassi spread non fa avanzare il generatore, ma copia le proprietà proprie ed enumerabili dell’oggetto generatore. Un generatore esaurito non può ripartire; occorre invece chiamare di nuovo la funzione. Un argomento di next(value) diventa il risultato dell’espressione yield sospesa; l’argomento del primo next() viene ignorato.

Puoi anche definire un generatore con un’espressione come const make = function* () { yield 1; };, in cui il nome della funzione è facoltativo. Non esiste una sintassi per le funzioni freccia generatrici. MDN classifica function* come ampiamente disponibile nei browser da settembre 2016; verifica separatamente il supporto del browser di destinazione.

Esempi

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(", "));

Risultato

10 | false
20 | false
30 | true
undefined | true
10, 20

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