CKTIS / JavaScript
Generator.prototype.next() — riprendere un generatore
Il metodo `next()` avvia o riprende un generatore sincrono e restituisce un oggetto con il risultato dell’iterazione. Il suo argomento facoltativo diventa il risultato di un’espressione `yield` semplice sospesa; l’argomento della prima chiamata viene ignorato.
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
generator.next()
generator.next(value)Generator.prototype.next è il metodo usato come generator.next(). Chiamare una funzione function* crea un generatore, ma non ne esegue il corpo. Il primo next() avvia l’esecuzione; le chiamate successive la riprendono fino alla sospensione successiva o al completamento.
Con un yield semplice, il risultato contiene il valore prodotto in value e ha done: false. Quando il generatore termina normalmente, il risultato ha done: true e in value contiene il valore di return, oppure undefined se non è stato fornito alcun valore. Le chiamate successive al completamento restituiscono { value: undefined, done: true }.
Durante la delega con yield*, se la proprietà done del risultato di next() dell’iteratore delegato vale false dopo la conversione in booleano, il next() del generatore esterno restituisce lo stesso oggetto senza modificarlo. Per esempio, se l’iteratore delegato restituisce {}, l’assenza di done viene interpretata come false e l’oggetto restituito continua a non avere né value né done.
Quando il generatore è sospeso su un yield semplice, l’argomento di next(value) diventa il risultato di quell’espressione. In const input = yield "ready", il primo passaggio fornisce "ready" e la chiamata successiva next(7) assegna 7 a input. L’argomento della prima chiamata viene ignorato perché il generatore non è ancora sospeso su un yield.
Rientrare con next() in un generatore in esecuzione provoca un TypeError. Ogni istanza percorre la propria sequenza una sola volta; richiama la funzione generatrice per ricominciare.
Esempi
function* exchange() {
const input = yield "ready";
return input * 2;
}
const generator = exchange();
function print(result) {
console.log(String(result.value) + " | " + result.done);
}
print(generator.next(999));
print(generator.next(7));
print(generator.next());Risultato
ready | false 14 | true undefined | 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.