Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje