AsyncGenerator.prototype.next()

next() 方法是 AsyncGenerator 实例的方法，用于返回序列中的下一个值。

语法

js
next()
next(value)

参数

value 可选

一个可选值，用于修改生成器的内部状态。传递给 next() 方法的值将由 yield 接收。

返回值

一个 Promise，在解析后返回一个具有两个属性的 Object

done

布尔值

  • 如果生成器已超出其控制流的末尾，则为 true。在这种情况下，value 指定生成器的返回值（可能为 undefined）。
  • 如果生成器能够生成更多值，则为 false。
value

生成器产生的任何 JavaScript 值。

示例

使用 next()

以下示例显示了一个简单的生成器以及 next 方法返回的对象。

js
// An async task. Pretend it's doing something more useful
// in practice.
function delayedValue(time, value) {
  return new Promise((resolve, reject) => {
    setTimeout(() => resolve(value), time);
  });
}

async function* createAsyncGenerator() {
  yield delayedValue(500, 1);
  yield delayedValue(500, 2);
  yield delayedValue(500, 3);
}

const asyncGen = createAsyncGenerator();
asyncGen.next().then((res) => console.log(res)); // { value: 1, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 2, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 3, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: undefined, done: true }

向生成器发送值

在此示例中，next 被调用并带有一个值。

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

js
// An async task. Pretend it's doing something more useful
// in practice.
function sleep(time) {
  return new Promise((resolve, reject) => {
    setTimeout(resolve, time);
  });
}

async function* createAsyncGenerator() {
  while (true) {
    await sleep(500);
    const value = yield;
    console.log(value);
  }
}

async function main() {
  const asyncGen = createAsyncGenerator();
  // No log at this step: the first value sent through `next` is lost
  console.log(await asyncGen.next(1)); // { value: undefined, done: false }
  // Logs 2: the value sent through `next`
  console.log(await asyncGen.next(2)); // { value: undefined, done: false }
}

main();

规范

规范
ECMAScript 语言规范
# sec-asyncgenerator-prototype-next

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅