JavaScript Promise.allSettled 怎样保留每个任务结果

如果多个异步任务彼此独立，但页面又必须知道每一个任务最后成功还是失败，Promise.allSettled() 比直接使用 Promise.all() 更合适。它会等待所有输入任务结束，并按输入顺序返回结果；要保留“哪个结果属于哪个任务”，关键不是依赖完成先后，而是保留任务描述数组，并用同一个索引合并结果。

官方文档：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/allSettled

把每个任务的 key、label 和执行函数放在 tasks 中，再执行 Promise.allSettled(tasks.map(task => task.run()))。由于结果数组与输入数组同序，使用 tasks[index] 就能稳定找回原任务；随后根据 status 读取 value 或 reason。

先分清这次迁移改变了什么

这里的“迁移”不是浏览器升级，而是把一组互不依赖的并发任务从“任意失败就整体拒绝”的处理方式，改成“每项都留下记录”的处理方式。Promise.all() 适合任务必须全部成功的场景；Promise.allSettled() 适合批量刷新、多个卡片分别加载、批量校验等场景。

它不是让失败消失，而是把失败转成结果记录。这样页面可以显示“用户信息成功、推荐列表失败”，而不是因为一项失败就丢掉其它已经完成的信息。

Promise.allSettled 为什么能保留输入对应关系

MDN 对该方法的定义有一个容易被忽略的重点：返回数组中的结果顺序与传入的可迭代对象顺序一致，与任务实际完成的先后无关。因此应该先固定 tasks，再从它生成输入 Promise 数组，最后按索引配对。

下面的例子给每个任务一个稳定的 key。run 只负责返回 Promise，结果整理放在调用方，避免把显示名称、请求函数和 settled 记录混成一个不可追踪的数组。

const tasks = [
  {
    key: "profile",
    label: "用户资料",
    // 每项都返回一个独立的异步任务。
    run: () => fetch("/api/profile").then(response => response.json())
  },
  {
    key: "recommendations",
    label: "推荐列表",
    // 失败会进入 allSettled 的 rejected 记录，不会抛掉其它结果。
    run: () => fetch("/api/recommendations").then(response => response.json())
  }
];

const settled = await Promise.allSettled(
  // 这里保持 tasks 的原顺序，结果数组也会保持同一顺序。
  tasks.map(task => task.run())
);

const records = settled.map((result, index) => ({
  // 同一个 index 把结果重新挂回原任务。
  key: tasks[index].key,
  label: tasks[index].label,
  status: result.status,
  value: result.status === "fulfilled" ? result.value : undefined,
  reason: result.status === "rejected" ? result.reason : undefined
}));

这里不需要按照完成时间重新排序。即使推荐接口先返回，settled[1] 仍然属于第二个输入任务；这正是保留对应关系的基础。

按 status 统一处理成功和失败

每个结果至少有 status。当它是 fulfilled 时才读取 value；当它是 rejected 时才读取 reason。不要直接访问 result.value 并把空值当成失败，因为成功任务本来就可能返回 null。

const successful = [];
const failed = [];

for (const record of records) {
  if (record.status === "fulfilled") {
    // 成功值可能是 null，因此以 status 作为判断依据。
    successful.push({ key: record.key, label: record.label, value: record.value });
    continue;
  }

  // rejected 的原因可能是 Error、字符串或自定义对象，先保留原值。
  failed.push({ key: record.key, label: record.label, reason: record.reason });
}

console.log({ successful, failed });

如果需要把结果交给组件渲染，可以直接使用 records。公共字段负责显示任务身份，状态字段负责选择展示分支，失败原因则可以转换成面向用户的提示，而不是把底层对象原样写进页面。

回归检查与边界清单

• 输入和结果必须同源：不要在等待期间对 tasks 重新排序、过滤或追加项，否则索引关联会失真。
• 任务互不依赖：如果第二个任务必须使用第一个任务的结果，就不应把它们硬塞进同一个独立任务批次。
• 副作用仍然发生：allSettled 只负责等待和记录，不会取消已经发出的请求，也不会自动重试失败任务。
• 空数组是特殊输入：传入空可迭代对象时会得到空结果；批处理代码仍应允许 records.length === 0。
• 保留原始错误：记录 reason 后再统一格式化，便于日志和界面分别使用。

迁移后可以重点检查三件事：成功和失败项是否都出现；每个 key 是否与原任务一致；失败时其它成功结果是否仍然可用。只要这三项成立，就说明“逐项保留结果”的核心目标已经达到。

常见问题

Promise.allSettled 的结果会按完成时间排序吗？

不会。结果数组按输入 Promise 的顺序排列，所以应保留输入任务数组，不要用完成时间推断任务身份。

为什么不直接给每个 Promise 加 key？

Promise 本身不是适合承载业务显示信息的记录对象。把 key、label 和执行函数放在任务描述中，再按索引合并，结构更清楚，也能统一处理成功和失败。

什么时候仍然应该使用 Promise.all？

当任意一项失败就没有继续意义，或者后续逻辑只有在所有结果都成功时才能执行，Promise.all() 的整体拒绝语义更直接。

总结

Promise.allSettled() 保留每个任务结果的核心做法是：先用任务描述保存稳定身份，再按原顺序生成 Promise，最后用同索引把任务与 settled 记录合并。处理记录时只看 status 决定读取 value 还是 reason，就能在批量异步场景中同时保留成功和失败信息。