CKTIS / JavaScript
Deklarace generátorové funkce a generátorová metoda
Oba zápisy definují synchronní generátorovou funkci. Deklarace zavádí jméno v dané oblasti platnosti, zatímco metoda patří objektu nebo třídě.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function* sequence(start) { yield start; }
const object = { *values() { yield this.start; } };
class Series { *values() { yield this.start; } }Deklarace function* sequence(start) { ... } zavádí jméno sequence ve své oblasti platnosti. Zápis *values() { ... } definuje metodu v objektu nebo třídě: hvězdička stojí před jménem metody a klíčové slovo function se nepíše. Při volání counter.values() má this uvnitř metody hodnotu counter.
Každé volání vrací nový synchronní generátor, který je zároveň iterátorem i iterovatelným objektem. Příkazy v těle se začnou provádět až při prvním volání next(). yield value pozastaví provádění, zachová lokální stav a poskytne výsledek ve tvaru { value, done: false }. Další volání next() v provádění pokračuje. Použití new s kteroukoli z těchto funkcí vyvolá TypeError.
Pokud next() dospěje k return value, výsledkem je { value, done: true }. Cyklus for...of i syntaxe rozbalení ... přebírají hodnoty z yield, ale vynechávají konečnou návratovou hodnotu. Po ukončení generátoru vracejí další volání next() výsledek { value: undefined, done: true }. Chceš-li začít od začátku, zavolej funkci nebo metodu znovu.
Příklady
{
function* sequence(start) {
yield start;
return start + 1;
}
const counter = {
start: 7,
*values() {
yield this.start;
},
};
const steps = sequence(3);
for (let i = 0; i < 3; i++) {
const { value, done } = steps.next();
console.log(`${value} ${done}`);
}
console.log(JSON.stringify([...counter.values()]));
}Výsledek
3 false 4 true undefined true [7]
Volání `next()` postupně ukážou hodnotu `3` z `yield`, hodnotu `4` z `return` a stav po vyčerpání generátoru. Rozbalení generátoru z `counter.values()` dává `[7]`, protože metoda čte `counter.start` prostřednictvím `this`.
Související lekce
- JavaScript · Lekce 8 · Pokročilá · Verze: 4