promise.all与promise.race_在javascript中如何使用?

Promise.all等待全部完成才成功(任一失败即拒绝),适用于所有请求必须成功的场景;Promise.race取第一个settled结果,适用于竞速或超时控制;Promise.allSettled则汇总所有结果状态,不因失败中断。

Promise.allPromise.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 更干净。

  • 返回数组,每个元素是 { 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」都只是透传,不会重新执行;而传入 undefinednull 或非 thenable 值会直接报 TypeError: Promise.all/race called on non-object —— 务必确保数组每一项都是有效 Promise 或可转换值。