promise.race、promise.all、promise.allSettled 有哪些区别?
参考答案
三者共同点
都接收可迭代的 Promise 集合,都返回一个新的 Promise,用于并发控制。
Promise.all
- 全部成功才成功,返回结果数组,顺序与输入一致(不是完成顺序)。
- 任一失败立即 reject(短路),其他 Promise 仍会继续执行(不能取消)。
- 空数组立即 resolve
[]。
await Promise.all([p1, p2]); // [r1, r2]
适用:多个请求都需要成功才能继续(首屏并发数据)。
Promise.race
- 第一个"落定"(resolve 或 reject)的结果决定整体结果,其余忽略。
- 常用于超时控制:
const timeout = (ms) => new Promise((_, rej) => setTimeout(() => rej(new Error('timeout')), ms));
await Promise.race([fetchData(), timeout(3000)]);
- 空数组会永远 pending。
Promise.allSettled
- 等全部落定,永不 reject;返回每个结果的状态:
const results = await Promise.allSettled([p1, p2]);
// [{status:'fulfilled', value}, {status:'rejected', reason}]
适用:批量操作中"允许部分失败",需要知道每一项的结果(批量上传、批量通知)。
对比表
| 方法 | 成功条件 | 失败条件 | 返回值 | 典型场景 |
| --- | --- | --- | --- | --- |
| all | 全部 fulfilled | 任一 rejected 立即失败 | 结果数组(有序) | 强依赖的并发请求 |
| race | 第一个 fulfilled | 第一个 rejected | 首个落定值 | 超时、竞速、镜像源 |
| allSettled | 全部落定 | 永不 reject | 状态数组 | 批量任务、容错汇总 |
补充
- 还有
Promise.any:第一个 fulfilled 成功(忽略 reject),全部失败才 rejectAggregateError;适合"多源取最快成功"。 all/race对非 Promise 值会自动Promise.resolve包装。- 想让失败不影响整体但要拿到结果 →
allSettled;想只要最快成功 →any。