Generator.prototype.next()

Baseline 已广泛支持

此特性已非常成熟,可在多种设备和浏览器版本上使用。自 ⁨2016 年 9 月⁩以来,它已在各大浏览器中可用。

next() 方法是 Generator 实例的一个方法,它会返回一个包含 donevalue 两个属性的对象。你也可以向 next 方法传递一个参数,用于向生成器发送值。

语法

js
next()
next(value)

参数

value 可选

要发送给生成器的值。

该值将被赋给 yield 表达式的结果。例如,在 variable = yield expression 中,传递给 .next() 函数的值将被赋给 variable

返回值

一个包含两个属性的 Object

done

一个布尔值。

  • 如果生成器已完成其控制流,则为 true。在这种情况下,value 指定生成器的返回值(可能为 undefined)。
  • 如果生成器能够产生更多值,则为 false
value

生成器产生或返回的任何 JavaScript 值。

异常

TypeError

如果生成器已在运行,则抛出错误。

示例

使用 next()

下面的示例展示了一个生成器以及 next 方法返回的对象

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

const g = gen(); // Generator { }
g.next(); // { value: 1, done: false }
g.next(); // { value: 2, done: false }
g.next(); // { value: 3, done: false }
g.next(); // { value: undefined, done: true }

使用 next() 处理列表

在此示例中,getPage 接收一个列表,并将其“分页”成大小为 pageSize 的块。每次调用 next 都会产生一个这样的块。

js
function* getPage(list, pageSize = 1) {
  for (let index = 0; index < list.length; index += pageSize) {
    yield list.slice(index, index + pageSize);
  }
}

const list = [1, 2, 3, 4, 5, 6, 7, 8];
const page = getPage(list, 3); // Generator { }

page.next(); // { value: [1, 2, 3], done: false }
page.next(); // { value: [4, 5, 6], done: false }
page.next(); // { value: [7, 8], done: false }
page.next(); // { value: undefined, done: true }

向生成器发送值

在此示例中,next 使用一个值进行了调用。

注意: 第一次调用不会记录任何内容,因为生成器最初没有产生任何内容。

js
function* gen() {
  while (true) {
    const value = yield;
    console.log(value);
  }
}

const g = gen();
g.next(1); // Returns { value: undefined, done: false }
// No log at this step: the first value sent through `next` is lost
g.next(2); // Returns { value: undefined, done: false }
// Logs 2

规范

规范
ECMAScript® 2026 语言规范
# sec-generator.prototype.next

浏览器兼容性

另见