Promise.all等待全部完成才成功（任一失败即拒绝），适用于所有请求必须成功的场景；Promise.race取第一个settled结果，适用于竞速或超时控制；Promise.allSettled则汇总所有结果状态，不因失败中断。
Promise.all 和 Promise.race 都是用于协调多个 Promise 的原生方法，但行为完全不同：前者等待全部完成才成功（任一失败即拒绝），后者只取第一个 settled（fulfilled 或 rejected）的结果。
什么时候用 Promise.all？
适合「所有请求都必须成功」的场景，比如批量获取用户资料、并行加载多个模块、表单提交前校验多个字段。
- 只要其中一个 Promise 被
reject，整个Promise.all就立即以该错误拒绝，其余仍在运行的 Promise 不会中断，但结果被丢弃 - 返回值是数组，顺序与输入数组一致，哪怕后启动的 Promise 先完成
- 传入空数组会立刻 resolve 一个空数组：
Promise.all([])→Promise.resolve([]) - 注意：如果传入非 Promise 值（如数字、字符串），会被自动包装成已 fulfilled 的 Promise
const p1 = Promise.resolve(1);
const p2 = fetch('/api/user').then(r => r.json());
const p3 = new Promise(resolve => setTimeout(() => resolve('done'), 100));
Promise.all([p1, p2, p3])
.then(results => console.log(results)) // [1, {…}, 'done']
.catch(err => console.error('某一个失败了', err));
什么时候用 Promise.race？
适合「谁快谁上」或「设置超时」的场景，比如接口兜底、竞速请求、防呆等待。
- 只要第一个 Promise 进入 settled 状态（无论 fulfill 还是 reject），
Promise.race就立刻结束并返回其结果 - 如果第一个 settled 的是 reject，整个 race 就 reject；如果是 fulfill，就 fulfill —— 不关心其他 Promise 后续状态
- 常见陷阱：没处理 reject 分支，导致未捕获错误直接抛出
const api = fetch('/api/data');
const timeout = new Promise((_, reject) =>
setTimeout(() => reject(new Error('timeout')), 5000)
);
Promise.race([api, timeout])
.then(res => res.json())
.catch(err => {
if (err.message === 'timeout') {
console.log('走降级逻辑');
} else {
console.error('真实接口报错', err);
}
});
Promise.allSettled 是不是更好？
它和 Promise.all 的关键区别在于：不因任一失败而中断，而是等全部 settled 后返回每个 Promise 的状态对象。如果你需要「不管成败都要汇总结果」，它比手动 try/catch + Promise.all 更干净。
立即学习“Java免费学习笔记（深入）”；
- 返回数组，每个元素是
{ status: 'fulfilled' | 'rejected', value | reason } - 浏览器支持从 Chrome 76 / Firefox 71 开始，Node.js 12.9+ 原生支持
- 不能替代
Promise.race—— 它不提供“最快响应”能力
Promise.allSettled([
Promise.resolve('a'),
Promise.reject(new Error('fail')),
Promise.resolve('b')
]).then(results => {
results.forEach((r, i) => {
if (r.status === 'fulfilled') {
console.log(`第${i}个成功：`, r.value);
} else {
console.log(`第${i}个失败：`, r.reason.message);
}
});
});
真正容易被忽略的是：所有这些方法对「已 settled 的 Promise」都只是透传，不会重新执行；而传入 undefined、null 或非 thenable 值会直接报 TypeError: Promise.all/race called on non-object —— 务必确保数组每一项都是有效 Promise 或可转换值。
