promise.allsettled 是 es2020 引入的方法,等待所有 promise 完成(无论 fulfilled 或 rejected),返回含 status、value/reason 的结果数组,不因单个失败而中断;区别于 promise.all 的“一拒全拒”。

Promise.allSettled 是 ES2020 引入的方法,专门用于等待**所有** Promise 完成(fulfilled 或 rejected),并返回每个任务的最终状态和结果,不因某个失败而中断或拒绝整个集合。
它和 Promise.all 的关键区别
• Promise.all:只要有一个 Promise reject,就立刻 reject 整个结果,其余还在进行的任务会被“放弃”(实际仍在运行,但结果被忽略);
• Promise.allSettled:不管成功失败,等全部结束,返回一个数组,每一项都明确标出 status: "fulfilled" 或 status: "rejected",并附带 value 或 reason。
基本用法示例
```js
const promises = [
fetch('/api/user'),
fetch('/api/posts').then(r => r.json()),
Promise.reject(new Error('Timeout')),
Promise.resolve({ id: 123 })
];
Promise.allSettled(promises)
.then(results => {
results.forEach((result, i) => {
if (result.status === 'fulfilled') {
console.log(`第 ${i} 个成功:`, result.value);
} else {
console.log(`第 ${i} 个失败:`, result.reason);
}
});
});
```
常见使用场景
• 批量请求且需汇总所有响应:比如同时调用多个微服务接口,即使部分超时或报错,也要拿到其余结果做降级展示;
• 资源清理或日志上报:发起多个异步日志记录,不希望某条失败影响其他;
• 表单多字段异步校验:所有字段校验 Promise 并行执行,统一收集通过/失败详情,再渲染错误提示。
注意点和小技巧
• 返回数组顺序与输入 Promise 数组严格一致,可直接按索引对应原始任务;
• 每个 result 对象结构固定:
✓ 成功时:{ status: 'fulfilled', value: … }
✗ 失败时:{ status: 'rejected', reason: … }
• 如果需要过滤出失败项,可用:results.filter(r => r.status === 'rejected');
• 配合 async/await 更清晰:
const results = await Promise.allSettled(promises);











