GeneratorFunction
{{JSRef}}
The GeneratorFunction
object provides methods for generator functions. In JavaScript, every generator function is actually a GeneratorFunction
object.
Note that GeneratorFunction
is not a global object. It can be obtained with the following code:
const GeneratorFunction = function* () {}.constructor;
GeneratorFunction
is a subclass of {{jsxref("Function")}}
.
{{InteractiveExample("JavaScript Demo: GeneratorFunction()", "taller")}}
const GeneratorFunction = function* () {}.constructor;
const foo = new GeneratorFunction(`
yield 'a';
yield 'b';
yield 'c';
`);
let str = "";
for (const val of foo()) {
str = str + val;
}
console.log(str);
// Expected output: "abc"
Constructor
{{jsxref("GeneratorFunction/GeneratorFunction", "GeneratorFunction()")}}
- : Creates a new
GeneratorFunction
object.
- : Creates a new
Instance properties
Also inherits instance properties from its parent {{jsxref("Function")}}
.
These properties are defined on GeneratorFunction.prototype
and shared by all GeneratorFunction
instances.
{{jsxref("Object/constructor", "GeneratorFunction.prototype.constructor")}}
- : The constructor function that created the instance object. For
GeneratorFunction
instances, the initial value is the{{jsxref("GeneratorFunction/GeneratorFunction", "GeneratorFunction")}}
constructor.
- : The constructor function that created the instance object. For
{{jsxref("GeneratorFunction.prototype.prototype")}}
- : All generator functions share the same
prototype
property, which isGenerator.prototype
. Each generator function created with thefunction*
syntax or theGeneratorFunction()
constructor also has its ownprototype
property, whose prototype isGeneratorFunction.prototype.prototype
. When the generator function is called, itsprototype
property becomes the prototype of the returned generator object.
- : All generator functions share the same
GeneratorFunction.prototype[Symbol.toStringTag]
- : The initial value of the
[Symbol.toStringTag]
property is the string"GeneratorFunction"
. This property is used in{{jsxref("Object.prototype.toString()")}}
.
- : The initial value of the
These properties are own properties of each GeneratorFunction
instance.
{{jsxref("GeneratorFunction/prototype", "prototype")}}
- : Used when the function is used as a constructor with the
new
operator. It will become the new object’s prototype.
- : Used when the function is used as a constructor with the
Instance methods
Inherits instance methods from its parent {{jsxref("Function")}}
.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
function*
function*
expression{{jsxref("Function")}}
{{jsxref("AsyncFunction")}}
{{jsxref("AsyncGeneratorFunction")}}
{{jsxref("Functions", "Functions", "", 1)}}