This article is in need of an editorial review.
This translation is incomplete. Please help translate this article from English.
これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。
概要
generator functionによってGenerator オブジェクトが返され、イテレータ と 反復プロトコルの両方に従います。
構文
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キーワードを使用します。しかしながら、レガシージェネレータは非推奨となっております。使用しないで下さい。そのうち取り除かれます。(バグ 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)
仕様
| 仕様 | 状況 | コメント |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Generator objects' in that specification. |
Standard | Initial definition. |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 未サポート | (有) | 未サポート | 未サポート | 未サポート |
| 機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 未サポート | (有) | 未サポート | 未サポート | 未サポート |
関連情報
レガシージェネレータ
- The legacy generator function
- The legacy generator function expression
StopIteration- The legacy Iterator protocol