function*

Сводка

function* (ключевое слово function со звёздочкой) определяет функцию-генератор.

Синтаксис

function* gen(i){
  while(true){
    yield i++;
    yield* anotherGenerator(i);
  }
}

Описание

Генераторы являются функциями с возможность повторного входа после выхода. Их контекст исполнения (значения переменных) сохраняется при последующих входах.

Вызов функции-генератора не вызывает немедленное исполнение её тела; вместо этого в ней возвращается объект итератор. При вызове метода итератора next(), тело функции-генератора возобновляет свою работу до первого встреченного оператора yield, который определяет возвращаемое значение или делегирует возврат другому генератору при помощи yield* anotherGenerator().

Примеры

Простой пример

function* idMaker(){
    var index = 0;
    while(true)
        yield index++;
}

var gen = idMaker();

console.log(gen.next().value); // 0
console.log(gen.next().value); // 1
console.log(gen.next().value); // 2
// ...

Спецификации

Совместимость с браузерами

Генераторы и итераторы до версии Firefox 26

В старых версиях Firefox была реализована иная версия генераторов. В ней генераторы определялись обычным ключевым словом function (без звёздочки) и имели некоторые другие отличия.

Смотрите также

• Протокол итераторов
• Оператор yield
• Оператор function
• Другие ресурсы:
  • Компилятор Regenerator из ES6 в ES5
  • Forbes Lindesay: Promises and Generators: control flow utopia -- JSConf EU 2013
  • Task.js