CKTIS / JavaScript
Generator.prototype.next() — reanudar un generador
El método `next()` inicia o reanuda un generador síncrono y devuelve un objeto con el resultado de la iteración. Su argumento opcional pasa a ser el resultado de una expresión `yield` simple suspendida; se ignora el argumento de la primera llamada.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
generator.next()
generator.next(value)Generator.prototype.next es el método que se usa como generator.next(). Al llamar a una función function* se crea un generador, pero no se ejecuta su cuerpo. El primer next() inicia la ejecución; las llamadas siguientes la reanudan hasta que vuelve a suspenderse o finaliza.
Con un yield simple, el resultado contiene el valor producido en value e indica done: false. Cuando el generador finaliza normalmente, el resultado contiene done: true y, en value, el valor de return o undefined si no se proporcionó ningún valor. Las llamadas posteriores a la finalización devuelven { value: undefined, done: true }.
Al delegar con yield*, si la propiedad done del resultado de next() del iterador delegado se convierte en false al evaluarse como valor booleano, el next() del generador externo devuelve ese mismo objeto sin modificarlo. Por ejemplo, si el iterador delegado devuelve {}, la ausencia de done se interpreta como false y el objeto devuelto sigue sin tener ni value ni done.
Cuando el generador está suspendido en un yield simple, el argumento de next(value) pasa a ser el resultado de esa expresión. En const input = yield "ready", el primer paso proporciona "ready" y la llamada siguiente, next(7), asigna 7 a input. Se ignora el argumento de la primera llamada porque el generador todavía no está suspendido en un yield.
Volver a entrar mediante next() en un generador que se está ejecutando provoca un TypeError. Cada instancia recorre su secuencia una sola vez; vuelve a llamar a la función generadora para empezar de nuevo.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.