大网数据广告活动
Web 标准与前端开发

AsyncGenerator

· 52CE 我爱测

**`AsyncGenerator`** 对象由Statements/async_function*返回,并且它符合异步可迭代协议和异步迭代器协议。

AsyncGenerator 对象由Statements/async_function*返回,并且它符合异步可迭代协议和异步迭代器协议。

异步生成器方法总是产生 Promise 对象。

AsyncGenerator 是隐藏类 AsyncIterator 的子类。

JavaScript Demo: Expressions - Async Function Asterisk

async function* foo() {
  yield await Promise.resolve("a");
  yield await Promise.resolve("b");
  yield await Promise.resolve("c");
}

let str = "";

async function generate() {
  for await (const val of foo()) {
    str = str + val;
  }
  console.log(str);
}

generate();
// Expected output: "abc"

构造函数

AsyncGenerator 构造函数并非全局可用的。AsyncGenerator 的实例必须从异步生成器函数返回。

async function* createAsyncGenerator() {
  yield await Promise.resolve(1);
  yield await Promise.resolve(2);
  yield await Promise.resolve(3);
}
const asyncGen = createAsyncGenerator();
asyncGen.next().then((res) => console.log(res.value)); // 1
asyncGen.next().then((res) => console.log(res.value)); // 2
asyncGen.next().then((res) => console.log(res.value)); // 3

实际上,并没有对应 AsyncGenerator 构造函数的 JavaScript 实体。只有一个隐藏对象,其是所有由异步生成器函数创建的对象所共享的原型对象。这个对象通常被风格化为 AsyncGenerator.prototype 来使其看起来像是一个类,但它更恰当的称呼应该是 AsyncGenerator.prototype.prototype,因为 AsyncGeneratorFunction 是一个实际的 JavaScript 实体。

实例属性

这些属性定义在 AsyncGenerator.prototype 并由所有 AsyncGenerator 实例共享。

  • Object/constructor

    • : 用于创建实例对象的构造函数。对于 AsyncGenerator 实例,初始值是 AsyncGeneratorFunction.prototype。

      [!NOTE] AsyncGenerator 对象并不会存储创建它们的异步生成器函数的引用。

  • AsyncGenerator.prototype[Symbol.toStringTag]

    • : [Symbol.toStringTag] 属性的初始值是字符串 "AsyncGenerator"。该属性在 Object.prototype.toString() 中使用。

实例方法

也从其父类 AsyncIterator 继承实例方法。

  • AsyncGenerator.prototype.next()
    • : 返回 Promise,它将通过 Operators/yield 表达式产生的给定值兑现。
  • AsyncGenerator.prototype.return()
    • : 就好像在生成器的暂停位置插入一个 return 语句,这将结束生成器并允许生成器执行任何清理任务,尤其是与 try...finally 块结合的时候。
  • AsyncGenerator.prototype.throw()
    • : 就好像在生成器的暂停位置插入一个 throw 语句,这将通知生成器错误的状况并允许去处理错误,或者执行清理操作并关闭它自己。

示例

迭代异步生成器

以下示例将遍历迭代异步生成器,以递减的时间间隔将值 1-6 打印到控制台。注意,每次产生 Promise 的时候,它会在 for await...of 循环中自动地兑现。

// 异步任务。假设它在实践中做了一些更有用的事情。
function delayedValue(time, value) {
  return new Promise((resolve /*, reject*/) => {
    setTimeout(() => resolve(value), time);
  });
}

async function* generate() {
  yield delayedValue(2000, 1);
  yield delayedValue(100, 2);
  yield delayedValue(500, 3);
  yield delayedValue(250, 4);
  yield delayedValue(125, 5);
  yield delayedValue(50, 6);
  console.log("全部完成!");
}

async function main() {
  for await (const value of generate()) {
    console.log("值", value);
  }
}

main().catch((e) => console.error(e));

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。