From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/generatorfunction/index.html | 94 ++++++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/generatorfunction/index.html (limited to 'files/ja/web/javascript/reference/global_objects/generatorfunction/index.html') diff --git a/files/ja/web/javascript/reference/global_objects/generatorfunction/index.html b/files/ja/web/javascript/reference/global_objects/generatorfunction/index.html new file mode 100644 index 0000000000..bb95e73d7d --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/generatorfunction/index.html @@ -0,0 +1,94 @@ +--- +title: GeneratorFunction +slug: Web/JavaScript/Reference/Global_Objects/GeneratorFunction +tags: + - Constructor + - ECMAScript 2015 + - GeneratorFunction + - Iterator + - JavaScript + - Reference + - コンストラクター +translation_of: Web/JavaScript/Reference/Global_Objects/GeneratorFunction +--- +
{{JSRef}}
+ +

GeneratorFunction コンストラクターは、新しい{{jsxref("Statements/function*", "ジェネレーター関数", "", 1)}}オブジェクトを生成します。 JavaScript では、すべてのジェネレーター関数が実際に GeneratorFunction オブジェクトです。

+ +

GeneratorFunction はグローバルオブジェクトではないことに注意してください。次のコードを評価することによって得られます。

+ +
Object.getPrototypeOf(function*(){}).constructor
+
+ +

構文

+ +
new GeneratorFunction ([arg1[, arg2[, ...argN]],] functionBody)
+ +

引数

+ +
+
arg1, arg2, ... argN
+
形式的な引数名として関数に使用される名前です。それぞれが有効な JavaScript の識別子であるか、カンマで区切った文字列のリストで、例えば "x", "theValue", "a,b" などです。
+
functionBody
+
関数定義を構成する JavaScript 文を含む文字列。
+
+ +

解説

+ +

GeneratorFunction コンストラクターで生成された{{jsxref("Statements/function*", "ジェネレーター関数", "", 1)}}オブジェクトは、関数が生成されたときにパースされます。これは、ジェネレーター関数を {{jsxref("Statements/function*", "function* 式")}}で定義してからコード内で呼び出す方法ほど効率的ではありません。というのも、そのような関数はコードの残りの部分と共にパースされるからです。

+ +

関数に渡されたすべての引数は、渡された順に、作成される関数内の引数の識別子の名前として扱われます。

+ +
+

注: {{jsxref("Statements/function*", "ジェネレーター関数")}}が GeneratorFunction コンストラクターによって生成された場合、生成コンテキストのクロージャは作成されません。常にグローバルスコープに生成されます。

+ +

実行すると、ローカル変数とグローバルグローバル変数にのみアクセスでき、 GeneratorFunction コンストラクターが呼び出されたスコープの変数にはアクセスできません。

+ +

これは、ジェネレーター関数式のコードで {{jsxref("Global_Objects/eval", "eval")}} を使用した場合とは異なります。

+
+ +

GeneratorFunction コンストラクターを (new 演算子を使用せずに) 関数として呼び出した場合、コンストラクターとして呼び出したときと同じ効果があります。

+ +

例

+ +

GeneratorFunction() コンストラクターからジェネレーター関数を生成する

+ +
var GeneratorFunction = Object.getPrototypeOf(function*(){}).constructor
+var g = new GeneratorFunction('a', 'yield a * 2');
+var iterator = g(10);
+console.log(iterator.next().value); // 20
+
+ +

仕様書

+ + + + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-generatorfunction-objects', 'GeneratorFunction')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.GeneratorFunction")}}

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf