Like Python Generators, JavaScript also supports Generator functions and Generator Objects.
Generator-Function : A generator-function is defined like a normal function, but whenever it needs to generate a value, it does so with the yield keyword rather than return. The yield statement suspends functionâs execution and sends a value back to caller, but retains enough state to enable function to resume where it is left off. When resumed, the function continues execution immediately after the last yield run.
Syntax :
// An example of generator function
function* gen(){
yield 1;
yield 2;
...
...
}
Generator-Object : Generator functions return a generator object. Generator objects are used either by calling the next method on the generator object or using the generator object in a âfor ofâ loop (as shown in the above program)
The Generator object is returned by a generating function and it conforms to both the iterable protocol and the iterator protocol.
<script>// Generate Function generates three // different numbers in three callsfunction * fun(){ yield 10; yield 20; yield 30; } // Calling the Generate Functionvar gen = fun();document.write(gen.next().value);document.write("<br>");document.write(gen.next().value);document.write("<br>");document.write(gen.next().value);</script> |
Below is an example code to print infinite series of natural numbers using a simple generator.
<script>// Generate Function generates an // infinite series of Natural Numbers function * nextNatural(){ var naturalNumber = 1; // Infinite Generation while (true) { yield naturalNumber++; }} // Calling the Generate Functionvar gen = nextNatural(); // Loop to print the first// 10 Generated numberfor (var i = 0; i < 10; i++) { // Generating Next Number document.write(gen.next().value); // New Line document.write("<br>");}</script> |
Output
1 2 3 4 5 6 7 8 9 10
Below is an example of how to manually return from a generator
<script> var array = ['a', 'b', 'c'];function* generator(arr) { let i = 0; while (i < arr.length) { yield arr[i++] }} const it = generator(array); // we can do it.return() to finish the generator </script> |
Encountering yield and yield* syntax
yield : pauses the generator execution and and it returns the value of the expression which is being written after the yield keyword.
yield* : it iterates over the operand and returns each value until done is true.
<script> const arr = ['a', 'b', 'c']; function* generator() { yield 1; yield* arr; yield 2;} for (let value of generator()) { document.write(value); document.write("<br>");} </script> |
Output
1 a b c 2
Another method to create iterable
<script> var createOwnIterable = { *[Symbol.iterator]() { yield 'a'; yield 'b'; yield 'c'; }} for (let value of createOwnIterable) { document.write(value); document.write("<br>");} <script> |
Output
a b c
Return from generator function
<script> function* generator() { yield 'a'; return 'result'; yield 'b';} var it = generator();document.write(JSON.stringify(it.next()));// {value: "a", done: false}document.write(JSON.stringify(it.next()));// {value: "result", done: true} </script> |
How to throw an exception from generator
<script> function* generator() { throw new Error('Error Occured');} const it = generator();it.next();// Uncaught Error: Error Occurred </script> |
Calling a generator from another generator
<script> function* firstGenerator() { yield 2; yield 3;} function* secondGenerator() { yield 1; yield* firstGenerator(); yield 4;} for (let value of secondGenerator()) { document.write(value) document.write("<br>");} </script> |
Output
1 2 3 4
Limitation of Generators
you can’t yield inside a callback in generators
<script> function* generator() { ['a', 'b', 'c'].forEach(value => yield value) // This will give syntax error} </script> |
Using async generators (for api call)
<script> const firstPromise = () => { return new Promise((resolve, reject) => { setTimeout(() => resolve(1), 5000) })} const secondPromise = () => { return new Promise((resolve, reject) => { setTimeout(() => resolve(2), 3000) })} async function* generator() { const firstPromiseResult = await firstPromise(); yield firstPromiseResult; const secondPromiseResult = await secondPromise(); yield secondPromiseResult;} var it = generator();for await(let value of it){ document.write(value); document.write("<br>");} </script> |
Output
(after 5 seconds) 1 (after 3 seconds) 2
Advantages of generators:
They are memory efficient as lazy evaluation takes place, i.e, delays the evaluation of an expression until its value is needed.
use-case (generators)
- writing generators in redux-saga
- async-await (Implemented with promise and generators)
