array.fromasync() 是 es2023 引入的静态方法，用于顺序等待并收集异步可迭代源（如异步迭代器、promise 数组）的结果，保证逻辑原子性：任一拒绝即中止并抛出错误。
Array.fromAsync() 是 ES2023 正式引入的静态方法，专为将**可迭代的异步数据源**（如异步迭代器、包含 Promise 的类数组、Promise 数组等）**一次性、顺序地等待并收集结果**而设计。它不追求“原子化”语义（JavaScript 中无真正内存级原子操作），但能保证**转换过程的完整性与顺序性**：要么全部成功，要么在首个拒绝处中止并抛出错误——这正是处理异步流时所需的“逻辑原子性”。
支持的输入类型：哪些异步源能直接用？
Array.fromAsync() 接收一个异步可迭代对象（AsyncIterable）或任何具备 [Symbol.asyncIterator] 方法的对象，也兼容普通可迭代对象（如数组）中含 Promise 的情况：
- 原生异步生成器函数返回的异步迭代器
- Node.js ReadableStream（v16.14+ 默认支持 async iteration）
- 自定义实现了
[Symbol.asyncIterator]的对象 - Promise 数组（如
[Promise.resolve(1), fetch('/api/a')]）——此时它会按序 await 每个 Promise
基础用法：从异步迭代器构造数组
无需手动写 for await...of 循环，一行即可完成收集：
async function* fetchUsers() {
yield fetch('/api/user/1').then(r => r.json());
yield fetch('/api/user/2').then(r => r.json());
yield fetch('/api/user/3').then(r => r.json());
}
<p>// ✅ 等价于手动遍历 + push，但更简洁、错误自动传播
const users = await Array.fromAsync(fetchUsers());</p>
若任一 yield 返回被拒绝的 Promise，整个 Array.fromAsync() 调用立即 reject，不会继续消费后续项。
配合映射函数：边转换边 await
第二个参数是映射函数，它会接收每次迭代的值，并可返回 Promise —— Array.fromAsync 会自动 await 它：
const urls = ['/api/data/1', '/api/data/2', '/api/data/3']; <p>const results = await Array.fromAsync( urls, async url => (await fetch(url)).json() );</p>
注意：这里的 urls 是同步可迭代对象（数组），但映射函数是异步的。Array.fromAsync 会按序执行每个映射调用，并等待其完成后再取下一个元素。
错误处理与中断语义
它的“逻辑原子性”体现在：只要有一个步骤失败（Promise reject 或迭代器 throw），整个操作终止，已收集的中间结果不可见。无法获得部分成功结果 —— 这正是区别于 Promise.allSettled() 的关键：
- 用
Array.fromAsync：失败即停，适合强一致性场景（如初始化必须全量加载） - 用
Promise.allSettled(urls.map(u => fetch(u)))：始终返回全部结果状态，适合容错聚合
如需降级策略（例如跳过失败项），需自行封装：
async function fromAsyncSafe(asyncIterable, mapFn) {
const result = [];
for await (const item of asyncIterable) {
try {
result.push(await mapFn?.(item) ?? item);
} catch (e) {
console.warn('Skipped item due to error:', e);
}
}
return result;
}
不复杂但容易忽略：Array.fromAsync 不是魔法，它依赖目标环境支持 Symbol.asyncIterator；使用前请确认运行时（如 Chrome 111+、Node.js 20.5+）已启用该特性。
