这个生成器对象是由一个生成器函数 generator function 返回的。并且它是同时遵守 The iterable protocol 可遍历协议和The iterator protocol 迭代器模式协议 .

语法

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

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

方法

Generator.prototype.next()
返回 yield 表达式产生的值.
Generator.prototype.return()
返回给定的值并结束生成器.
Generator.prototype.throw()
向生成器抛出错误.

示例

无穷迭代器

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) 在 JavaScript 1.7 中也实现了生成器的一个早期版本,该版本的生成器不需要在生成器函数声明时使用星号(*),只需在函数体中使用yield 关键字即可,尽管如此,该生成器已被废弃,在将来会被移除,请勿使用 (bug 1083482).

旧生成器方法

Generator.prototype.next()
返回 yield 表达式产生的值. 与ES6 生成器对象的next()方法对应.
Generator.prototype.close()
关闭生成器,因此执行该函数后调用next()函数时将会抛出 StopIteration 错误. 与ES6 生成器对象的return()方法对应..
Generator.prototype.send()
用于将值发送到生成器Used to send a value to a generator. 该值由 yield 表达式返回, 并且返回下一个 yield 表达式产生的值. send(x) 对应于ES6生成器对象中的 next(x)
Generator.prototype.throw()
向生成器抛出错误. 与ES6 生成器对象的throw()方法对应.

旧生成器对象示例

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)

规范

Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
Generator objects
Standard Initial definition.
ECMAScript 2017 Draft (ECMA-262)
Generator objects
Draft  

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 39.0 (Yes) 未实现 未实现 未实现
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 未实现 39.0 (Yes) 未实现 未实现 未实现

相关链接

Legacy generators

ES6 generators

文档标签和贡献者

 此页面的贡献者: Yelmor, lanezhao, Ende93, panhezeng, ziyunfei, Javascipt, lukywong, jpmedley
 最后编辑者: Yelmor,