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