Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti