GeneratorFunction
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 += val;
}
console.log(str);
// Expected output: "abc"
Constructor
{{jsxref("GeneratorFunction/GeneratorFunction", "GeneratorFunction()")}}- : Creates a new
GeneratorFunctionobject.
- : 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
GeneratorFunctioninstances, 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
prototypeproperty, which isGenerator.prototype. Each generator function created with thefunction*syntax or theGeneratorFunction()constructor also has its ownprototypeproperty, whose prototype isGeneratorFunction.prototype.prototype. When the generator function is called, itsprototypeproperty 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
newoperator. 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)}}