Array.fromAsync 目前不可用，因其仍处于 TC39 Stage 3 提案阶段，V8 等引擎尚未实现，所有主流环境均无原生支持，直接调用会报 TypeError；可靠替代方案是 for await...of 手动收集。
Array.fromAsync 尚未进入 ECMAScript 正式标准，目前（截至 2024 年中）仍是 Stage 3 提案（tc39/proposal-array-from-async），所有主流浏览器和 Node.js 均未原生支持。直接调用会报 TypeError: Array.fromAsync is not a function。
为什么现在不能直接用 Array.fromAsync
该方法依赖底层对异步迭代器（AsyncIterator）的原生解析能力，而 V8、SpiderMonkey 等引擎尚未实现其规范逻辑。即使你看到某些 polyfill 库导出同名函数，那也只是模拟行为，不等于语言内置支持。
- Chrome 125 / Firefox 126 / Safari 17.5：无
Array.fromAsync全局属性 - Node.js 20.x / 21.x：未启用该提案，
globalThis.Array.fromAsync为undefined - TypeScript 类型定义（如
lib.es2023.array.d.ts）也未包含该接口，强行声明会导致类型错误
替代方案：用 for await...of 手动收集
这是目前最可靠、兼容性最好、语义最清晰的方式。它天然适配任何异步可迭代对象（AsyncGenerator、ReadableStream、自定义 [Symbol.asyncIterator]）。
const asyncIterable = (async function* () {
yield await Promise.resolve(1);
yield await Promise.resolve(2);
yield await Promise.resolve(3);
})();
<p>async function toArray(iter) {
const result = [];
for await (const item of iter) {
result.push(item);
}
return result;
}</p><p>toArray(asyncIterable).then(console.log); // [1, 2, 3]</p>- 不会提前消费整个异步流，内存友好（适合大流）
- 错误可被
try/catch捕获在循环内，控制粒度细 - 不需要额外依赖或转译配置
如果非要“类 Array.fromAsync”写法：封装一个工具函数
你可以自己写一个轻量函数，接受异步可迭代对象 + 可选映射函数，行为尽量贴近提案设计：
async function arrayFromAsync(iterable, mapFn) {
const result = [];
let index = 0;
for await (const item of iterable) {
const mapped = mapFn ? await mapFn(item, index++) : item;
result.push(mapped);
}
return result;
}
<p>// 使用示例
arrayFromAsync(
fetch('/api/items').then(r => r.json()[Symbol.asyncIterator]()),
x => x.id
).then(ids => console.log(ids));</p>- 注意：若
mapFn是异步函数，必须用await调用，否则会把 Promise 对象直接推入数组 - 不支持
thisArg参数（提案中也没有），如需绑定上下文，请预绑定mapFn - 不处理
length或稀疏索引——异步迭代器本身是顺序、稠密的
警惕基于 Promise.all 的“捷径”写法
有人尝试先展开迭代器再 Promise.all，但这是错的：
// ❌ 错误：iterable 不是数组，不能 spread const arr = await Promise.all([...asyncIterable]); // TypeError <p>// ❌ 更隐蔽的错：手动展开会立即触发所有异步操作，失去流控 const items = []; for (const p of asyncIterable) items.push(p); // p 是 Promise？不，asyncIterable 是 async iterable，不能 for-of 同步遍历</p>
-
for...of无法同步遍历异步迭代器，必须用for await...of -
Promise.all适用于已知长度的 Promise 数组，但异步迭代器长度未知、也不应一次性启动全部任务 - 若强行转换为数组再
all，可能造成内存溢出或服务端限流拒绝
真正要等 Array.fromAsync 落地，得看提案推进节奏和引擎厂商排期；在此之前，老老实实用 for await...of 是唯一不踩坑的选择。别信 npm 上名字带 array-from-async 的包——它们只是语法糖，掩盖不了底层仍是手写循环的事实。
