CKTIS / JavaScript
Generatorfunctie: function*
Een generatorfunctie maakt een iterator waarvan de uitvoering bij yield kan pauzeren en via next() kan worden hervat. De functie berekent waarden wanneer dat nodig is en behoudt de lokale toestand tussen opeenvolgende stappen.
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
function* name(parameters) {
yield value;
return finalValue;
}De declaratie function* name(parameters) { ... } definieert een generatorfunctie. Een aanroep maakt een nieuw Generator-object, maar voert de functie-inhoud nog niet uit. Elk object heeft een eigen uitvoeringstoestand; de eerste next() start de functie-inhoud en yield value levert een waarde en pauzeert de uitvoering.
Een volgende next() hervat de uitvoering na yield en behoudt lokale variabelen. Het resultaat heeft de velden value en done: yield levert done: false op, terwijl return finalValue de generator beëindigt met done: true. Zonder expliciete return is de eindwaarde undefined. Na afloop leveren verdere aanroepen van next() value: undefined en done: true op.
Een generatorobject is zowel een iterator als een itereerbaar object. for...of en de spread-syntaxis (...) in arrayliteralen en in argumentlijsten van functieaanroepen verwerken waarden uit yield, maar laten de eindwaarde uit return weg. In objectliteralen laat de spread-syntaxis de generator niet verdergaan, maar kopieert ze de eigen opsombare eigenschappen van het generatorobject. Een uitgeputte generator kan niet opnieuw starten; roep in plaats daarvan de functie opnieuw aan. Een argument voor next(value) wordt het resultaat van de gepauzeerde yield-expressie; het argument van de eerste next() wordt genegeerd.
Je kunt een generator ook definiëren met een expressie zoals const make = function* () { yield 1; };, waarbij de functienaam optioneel is. Er bestaat geen generator-syntaxis voor pijlfuncties. MDN classificeert function* sinds september 2016 als breed beschikbaar in browsers; controleer de ondersteuning in de doelbrowser afzonderlijk.
Voorbeelden
function* steps() {
yield 10;
yield 20;
return 30;
}
const iterator = steps();
for (let i = 0; i < 4; i++) {
const { value, done } = iterator.next();
console.log(`${value} | ${done}`);
}
console.log([...steps()].join(", "));Resultaat
10 | false 20 | false 30 | true undefined | true 10, 20
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.