CKTIS / JavaScript
Generator.prototype.next() — retomar um gerador
O método `next()` inicia ou retoma um gerador síncrono e devolve um objeto com o resultado da iteração. O argumento opcional passa a ser o resultado de uma expressão `yield` simples suspensa; o argumento da primeira chamada é ignorado.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
generator.next()
generator.next(value)Generator.prototype.next é o método utilizado como generator.next(). Chamar uma função function* cria um gerador, mas não executa o seu corpo. O primeiro next() inicia a execução; as chamadas seguintes retomam-na até à próxima suspensão ou até à conclusão.
Com um yield simples, o resultado contém o valor disponibilizado em value e indica done: false. Quando o gerador termina normalmente, o resultado contém done: true e o valor de return em value, ou undefined se não tiver sido fornecido nenhum valor. As chamadas posteriores à conclusão devolvem { value: undefined, done: true }.
Durante a delegação com yield*, se a propriedade done do resultado de next() do iterador delegado for false após a conversão para um valor booleano, o next() do gerador exterior devolve o mesmo objeto sem o alterar. Por exemplo, se o iterador delegado devolver {}, a ausência de done é interpretada como false e o objeto devolvido continua sem value nem done.
Quando o gerador está suspenso num yield simples, o argumento de next(value) passa a ser o resultado dessa expressão. Em const input = yield "ready", o primeiro passo disponibiliza "ready" e a chamada seguinte, next(7), atribui 7 a input. O argumento da primeira chamada é ignorado, porque o gerador ainda não está suspenso num yield.
Voltar a entrar através de next() num gerador que está a ser executado provoca um TypeError. Cada instância percorre a sua sequência apenas uma vez; chama novamente a função geradora para recomeçar.
Exemplos
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());Resultado
ready | false 14 | true undefined | true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.