Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Deklaracja funkcji generatora i metoda generatora

Obie składnie tworzą funkcję generatora synchronicznego. Deklaracja wprowadza nazwę w danym zakresie, a metoda jest składową obiektu lub klasy.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

function* sequence(start) { yield start; }
const object = { *values() { yield this.start; } };
class Series { *values() { yield this.start; } }

Deklaracja function* sequence(start) { ... } wprowadza nazwę sequence w danym zakresie. Zapis *values() { ... } definiuje metodę w obiekcie lub klasie: gwiazdka stoi przed nazwą metody, a słowa function się nie używa. Przy wywołaniu counter.values() wartością this w metodzie jest counter.

Zwykłe wywołanie dowolnej z tych funkcji zwraca nowy generator synchroniczny, który jest iteratorem i obiektem iterowalnym. Instrukcje w ciele zaczynają się wykonywać dopiero przy pierwszym next(). yield value wstrzymuje wykonanie, zachowuje stan lokalny i zwraca wynik w postaci { value, done: false }. Następne next() wznawia wykonanie. Użycie new z którąkolwiek z tych funkcji powoduje TypeError.

Gdy next() doprowadzi do return value, zwraca { value, done: true }. Pętla for...of i składnia rozwijania ... pobierają wartości z yield, ale pomijają końcową wartość return. Po zakończeniu każde kolejne next() zwraca { value: undefined, done: true }. Aby zacząć od nowa, ponownie wywołaj funkcję lub metodę.

Przykłady

{
  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()]));
}

Wynik

3 false
4 true
undefined true
[7]

Wywołania `next()` pokazują kolejno wartość z `yield` (`3`), wartość z `return` (`4`) oraz stan po zakończeniu. Rozwinięcie generatora z `counter.values()` daje `[7]`, ponieważ metoda odczytuje `counter.start` przez `this`.

Powiązane lekcje

  • JavaScript · Lekcja 8 · Zaawansowany · Wersja: 4

Źródła