for await...of 无法捕获异步生成器 return 语句产生的最终值，因其仅遍历 done: false 的 yield 项；需改用显式迭代器调用 .next() 并检查 done: true 时的 value。
`for await...of` 无法捕获异步生成器 `return` 语句产生的最终值，因其仅遍历 `done: false` 的 `yield` 项；需改用显式迭代器调用 `.next()` 并检查 `done: true` 时的 `value`。
在 JavaScript 中，异步生成器（async function*）既支持 yield 输出中间值，也支持 return 指定迭代完成后的最终返回值。该返回值会作为 IteratorResult 对象的 value 字段，在 done: true 时被传递——但 for await...of 语法刻意忽略这一终态结果，仅处理所有 done: false 的 yield 值。
例如以下代码：
async function* resolveData<t>(data: unknown): AsyncGenerator<number number> {
if (true) {
if (true) {
console.log("valid");
yield 1; // → part = 1（被 for await 捕获）
}
}
return 2; // → value = 2, done = true（被 for await 忽略）
}
// ❌ 仅输出 { part: 1 }，无法访问 return 值 2
for await (const part of resolveData({})) {
console.log({ part });
}</number></t>
✅ 正确获取返回值的两种方式
方案一：用 yield 替代 return（适用于返回值可作为“最后一个产出项”）
若业务逻辑允许将返回值视为数据流的末尾元素，直接 yield 即可：
async function* resolveData<t>(data: unknown): AsyncGenerator<number> {
if (true) {
if (true) {
console.log("valid");
yield 1;
}
}
yield 2; // ✅ 现在 2 也会被 for await 捕获
}
// ✅ 输出：{ part: 1 }、{ part: 2 }
for await (const part of resolveData({})) {
console.log({ part });
}</number></t>
⚠️ 注意：此时生成器不再有独立的“完成返回值”，类型变为
AsyncGenerator（而非AsyncGenerator），语义上是“产出一系列值”，而非“产出值 + 最终状态”。
方案二：手动调用 .next()（推荐：保留语义完整性）
当必须区分“中间产出”与“最终返回值”（如错误码、统计摘要、聚合结果等），应绕过语法糖，显式控制迭代过程：
async function* resolveData<t>(data: unknown): AsyncGenerator<number number> {
if (true) {
if (true) {
console.log("valid");
yield 1;
}
}
return 2; // ✅ 保持为 final value
}
// ✅ 显式迭代，捕获全部 value（含 done: true 时的 return 值）
const iterator = resolveData({});
let result: IteratorResult<number number>;
while (!(result = await iterator.next()).done) {
console.log("Yielded:", result.value); // → 1
}
console.log("Returned:", result.value); // → 2（final return value）</number></number></t>
此方式完全兼容 AsyncGenerator 类型定义，精准分离数据流（yield）与终结状态（return），是类型安全且语义清晰的最佳实践。
小结
-
for await...of是语法糖，不暴露迭代器的done: true结果； -
return在生成器中不是“退出函数”，而是设置终结value，必须通过.next()手动读取； - 若需统一处理所有数值，优先
yield；若需区分过程与结果，务必使用显式迭代； - TypeScript 用户注意：声明
AsyncGenerator可帮助编译器校验return类型，避免运行时隐式undefined。
