Generator

Generator là một object return bởi một generator function, nó phù hợp với cả iterable protocol và iterator protocol.

function* gen() {
  yield 1;
  yield 2;
  yield 3;
}

var g = gen(); // "Generator { }"

Generator.prototype.next() (en-US)

Trả về giá trị yielded, được khai báo qua câu lệnh yield (en-US).

Generator.prototype.return() (en-US)

Trả về giá trị và kết thúc generator.

Generator.prototype.throw() (en-US)

Quăng lỗi vào generator (đồng thời kết thúc generator, trừ khi được bắt lại trong generator đó).

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) đã hiện thực phiên bản generators đầu tiên trong JavaScript 1.7, lúc đó dấu sao (*) trong khai báo không bắt buộc (bạn chỉ cần dùng từ khóa yield bên trong hàm). Tuy nhiên, kiểu viết này đã không còn được hổ trợ từ Firefox 58 (released ngày 23, tháng 1, 2018) (bug 1083482).

Generator.prototype.next()

Returns a value yielded by the yield (en-US) expression. This corresponds to next() in the ES2015 generator object.

Generator.prototype.close()

Closes the generator, so that when calling next() an StopIteration error will be thrown. This corresponds to the return() method in the ES2015 generator object.

Generator.prototype.send()

Used to send a value to a generator. The value is returned from the yield (en-US) expression, and returns a value yielded by the next yield (en-US) expression. send(x) corresponds to next(x) in the ES2015 generator object.

Generator.prototype.throw()

Throws an error to a generator. This corresponds to the throw() method in the ES2015 generator object.

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)

• The legacy generator function
• The legacy generator function expression
• StopIteration
• The legacy Iterator protocol

• Functions
• function (en-US)
• function expression
• Function
• function*
• function* expression (en-US)
• GeneratorFunction
• The Iterator protocol