CKTIS / JavaScript
Generator.prototype.next() — een generator hervatten
De methode `next()` start of hervat een synchrone generator en retourneert een iteratieresultaatobject. Bij een gewone `yield` wordt het optionele argument het resultaat van de onderbroken expressie; het argument van de eerste aanroep wordt genegeerd.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
generator.next()
generator.next(value)Generator.prototype.next is de methode die je gebruikt als generator.next(). Een function*-functie aanroepen maakt een generator, maar voert de functie-inhoud niet uit. De eerste next() start de uitvoering; latere aanroepen hervatten die totdat de generator opnieuw pauzeert of klaar is.
Bij een gewone yield bevat het resultaat de opgeleverde waarde in value en geldt done: false. Als de generator normaal eindigt, bevat het resultaat done: true en staat in value de waarde van return, of undefined als er geen waarde is opgegeven. Aanroepen na voltooiing retourneren { value: undefined, done: true }.
Bij delegatie via yield* retourneert de next() van de buitenste generator hetzelfde object ongewijzigd als done in het resultaat van de next() van de gedelegeerde iterator na omzetting naar een booleaanse waarde false is. Retourneert de gedelegeerde iterator bijvoorbeeld {}, dan wordt de ontbrekende eigenschap done als false behandeld en bevat het geretourneerde object nog steeds geen van beide eigenschappen, value en done.
Als de generator bij een gewone yield is onderbroken, wordt het argument van next(value) het resultaat van die expressie. In const input = yield "ready" levert de eerste stap "ready" op, en de daaropvolgende next(7) wijst 7 toe aan input. Het argument van de eerste aanroep wordt genegeerd, omdat de generator nog niet bij een yield is onderbroken.
Roep je next() aan op een generator die al bezig is met uitvoeren, dan krijg je een TypeError. Elke instantie doorloopt de reeks maar één keer; roep de generatorfunctie opnieuw aan om opnieuw te beginnen.
Voorbeelden
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());Resultaat
ready | false 14 | true undefined | true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.