promise.allSettled 用于处理多个异步任务，无论成功或失败都会返回所有结果。它接收一个 Promise 数组，返回一个在所有 Promise 完成后才 resolve 的新 Promise，结果数组包含每个 Promise 的状态（fulfilled 或 rejected）及对应值或原因。与 Promise.all 不同，它不会因某个 Promise 失败而短路，适用于批量请求、并行校验、数据采集等需获取全部结果的场景。例如表单多字段校验、微服务接口并行调用、图片批量上传等，能确保所有任务执行完毕并收集最终状态。相比 Promise.all（全成功才成功）、Promise.race（取最快完成），allSettled 更适合需要“全部完成总览”的情况。掌握它可避免个别失败中断整体流程，提升容错能力。
当需要同时处理多个异步任务，并且希望无论成功或失败都能获取每个任务的结果时，Promise.allSettled 是最佳选择。它不会因为某个 Promise 失败而中断整个流程，适合用于批量请求、数据采集、并行校验等场景。
什么是 Promise.allSettled
Promise.allSettled 接收一个 Promise 数组作为参数，返回一个新的 Promise，该 Promise 在所有输入的 Promise 都“完成”（无论是 fulfilled 还是 rejected）后才 resolve。返回结果是一个对象数组，每个对象包含对应 Promise 的状态和结果：
- status: “fulfilled”，带 value
- status: “rejected”，带 reason
与 Promise.all 不同，allSettled 不会短路。即使其中一个 Promise 抛错，其他任务仍会继续执行。
基本使用示例
下面是一个并发请求用户信息的例子：
const fetchUser = id => id > 0 ? Promise.resolve({ id, name: `User ${id}` }) : Promise.reject(new Error(`Invalid ID: ${id}`)); const promises = [ fetchUser(1), fetchUser(2), fetchUser(-1), fetchUser(3) ]; Promise.allSettled(promises).then(results => { results.foreach((result, index) => { if (result.status === ‘fulfilled’) { console.log(`请求 ${index + 1} 成功:`, result.value); } else { console.log(`请求 ${index + 1} 失败:`, result.reason.message); } }); });
输出结果会显示前三项中三项完成，其中一项失败，但整体流程不受影响。
实际应用场景
在真实项目中，Promise.allSettled 特别适用于以下情况：
例如，在上传多张图片时：
const uploadImage = url => fetch(url).then(() => `上传成功: ${url}`) .catch(() => `上传失败: ${url}`); const urls = [‘/img1.jpg’, ‘/img2.jpg’, ‘/broken.jpg’]; const uploads = urls.map(uploadImage); Promise.allSettled(uploads).then(results => { const summary = results.map((r, i) => ({ url: urls[i], status: r.status, message: r.status === ‘fulfilled’ ? r.value : r.reason })); console.table(summary); });
与 Promise.all 和 Promise.race 的对比
理解三者差异有助于正确选择：
- Promise.all：全成功才成功，一旦有失败立即 reject
- Promise.race：只取最快完成的那个，无论成败
- Promise.allSettled：等待全部结束，返回每一个结果
如果你需要“全部完成后的总览”，而不是“全部成功才能继续”，就该用 allSettled。
基本上就这些。掌握 Promise.allSettled 能让你更从容地处理复杂的异步批量操作，避免因个别失败导致整体中断的问题。不复杂但容易忽略。