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 特别适用于以下情况:
PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用
一键操作,智能生成专业级PPT
37 查看详情
表单中多个字段的远程校验:即使某一项失败,也收集全部校验结果 微服务架构下并行调用多个接口,汇总展示成功与失败项 批量导入操作,记录每条数据的处理状态 前端监控上报,确保所有日志尝试发送完毕
例如,在上传多张图片时:
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 能让你更从容地处理复杂的异步批量操作,避免因个别失败导致整体中断的问题。不复杂但容易忽略。
以上就是使用Promise.allSettled处理多个异步操作的完整指南的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/307445.html
微信扫一扫
支付宝扫一扫