Array.fromAsync 是 ECMAScript Stage 3 提案的异步迭代器转数组方法，仅 Chromium 128+ 原生支持，Firefox 和 Safari 尚未实现；它按序消费 AsyncIterator，内存友好，不可用 polyfill 完全替代，降级方案为 for await...of 或 Promise.all（限已知长度且可并发场景）。
Array.fromAsync 是什么，浏览器支持现状如何
Array.fromAsync 是 ECMAScript 提案 Stage 3 的异步迭代器转数组方法，目前仅 Chromium 128+（含 Chrome、Edge、Opera）原生支持，Firefox 和 Safari 尚未实现。它不是 Array.from 的简单异步封装，而是专为处理 AsyncIterator 设计的底层机制——比如从 fetch 流、ReadableStream、或自定义异步生成器中逐项消费并收集。
不支持时直接调用会抛出 TypeError: Array.fromAsync is not a function，别指望 polyfill 完全模拟其行为（尤其涉及流式背压或取消时）。
可用的降级路径只有两种：for await...of 手动推入数组，或用 Promise.all + Array.from 预先知道长度且可并发的场景。
用 Array.fromAsync 拉取 fetch 响应流中的 JSON 行（NDJSON）
NDJSON（每行一个 JSON）响应适合流式解析，Array.fromAsync 能自然衔接 response.body 的异步迭代能力：
const response = await fetch('/api/logs');
const reader = response.body.getReader();
const iterator = {
async next() {
const { done, value } = await reader.read();
if (done) return { done: true, value: undefined };
return { done: false, value: JSON.parse(new TextDecoder().decode(value)) };
},
[Symbol.asyncIterator]() { return this; }
};
const logs = await Array.fromAsync(iterator);
注意点：
-
response.body.getReader()返回的是ReadableStreamDefaultReader，不能直接传给Array.fromAsync，必须包装成符合AsyncIterator协议的对象 -
TextDecoder必须在每次read()后解码，不能累积 buffer（否则可能截断 UTF-8 多字节字符） - 如果后端返回的是完整 JSON 数组而非 NDJSON，直接用
response.json()更合适，没必要绕路
Array.fromAsync 和 Promise.all([...asyncIter]) 的行为差异
两者都返回 Promise<array></array>，但执行模型完全不同：
-
Array.fromAsync(asyncIter)严格按顺序消费迭代器，一次只等待一个next()，内存占用低，适合无限流或大体积数据 -
Promise.all([...asyncIter])会先展开整个异步迭代器到数组（触发所有next()并立即 await），然后并发执行所有返回的 Promise——这既不可控又容易 OOM
例如处理一个返回 10 万条记录的 AsyncGenerator：
-
Array.fromAsync(gen())内存峰值约等于单条记录大小 -
[...gen()]会尝试一次性把 10 万个 Promise 实例塞进内存，大概率卡死
另外，Array.fromAsync 支持 mapFn 第二个参数，类似同步版的 Array.from(array, mapper)，但映射函数本身可以是异步的：
await Array.fromAsync(asyncIter, async item => transform(item));
这个 transform 会按序执行，不是并发。
常见报错和绕过方式
TypeError: Iterator result undefined is not an object：说明你的 AsyncIterator 的 next() 方法没返回符合规范的对象（必须有 done 和 value 字段）。检查是否忘了 return { done: true } 终止条件。
TypeError: asyncIterator is not an async iterable：传入的是普通对象或同步迭代器。确认对象上有 [Symbol.asyncIterator] 方法，且返回的是异步迭代器对象。
无法取消进行中的 Array.fromAsync：目前没有标准取消机制。如果需要中断，得自己在 next() 中检查 AbortSignal 状态，并手动 throw AbortError。
真正难处理的不是语法，是异步迭代器本身的健壮性——比如网络中断时 reader 的 read() 抛错，你得在 next() 里加 try/catch 并正确设置 done: true，否则 Array.fromAsync 会一直挂起。
