Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes