Generator

概要

Generator オブジェクトは ジェネレーター関数 によって返され、iterable プロトコル と iterator プロトコル の両方に従います。

構文

function* gen() { 
  yield 1;
  yield 2;
  yield 3;
}

var g = gen(); // "Generator { }"

メソッド

Generator.prototype.next()

yield 式によって得られる値を返します。

Generator.prototype.return()

与えられた値を返し、ジェネレーターを終了します。

Generator.prototype.throw()

エラーをジェネレーターにスローします。(ジェネレータ内でキャッチされない限り、そのジェネレータも終了します)

例

無限イテレーター

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

var gen = idMaker(); // "Generator { }"

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

レガシージェネレーターオブジェクト

Firefox (SpiderMonkey) は JavaScript 1.7 で、ジェネレーター初期バージョンも実装しました。これは関数の宣言でアスタリスク (*) を必要としません (関数の本体で yield キーワードを使用するだけです)。しかし、レガシージェネレータのサポートはFirefox58から削除されています。(2018年1月23日リリース) (バグ 1083482)。

レガシージェネレーターメソッド

Generator.prototype.next()

yield 式によって得られる値を返します。 これは ES6 ジェネレーターオブジェクトの next() と一致します。

Generator.prototype.close()

ジェネレーターを閉じます。そのため、next() をコールすると、StopIteration エラーがスローされます。これは ES6 ジェネレーターオブジェクトの return() メソッドに一致します。

Generator.prototype.send()

ジェネレーターに値を送るために使われます。yield 式から値が返され、次の yield 式によって値を返します。send(x) は ES6 ジェネレーターオブジェクトの next(x) に一致します。

Generator.prototype.throw()

ジェネレーターにエラーをスローします。これはES6ジェネレーターオブジェクトの throw() に一致します。

レガシージェネレーターの例

function fibonacci() {
  var a = yield 1;
  yield a * 2;
}

var it = fibonacci();
console.log(it);          // "Generator {  }"
console.log(it.next());   // 1
console.log(it.send(10)); // 20
console.log(it.close());  // undefined
console.log(it.next());   // throws StopIteration (as the generator is now closed)

仕様

ブラウザー実装状況