Promise.allSettled方法详解与使用教程

在JavaScript异步编程中，`Promise.allSettled` 是一种强大的工具，用于处理多个Promise，无论它们成功还是失败，都能确保所有Promise执行完毕并返回一个包含每个Promise结果状态的报告。与`Promise.all`不同，`Promise.allSettled` 不会因单个Promise的失败而中断，而是等待所有Promise落定。它返回一个数组，每个元素包含`status`（`'fulfilled'`或`'rejected'`）以及对应的`value`或`reason`，非常适合需要完整结果报告的场景，如批量操作、数据收集、非关键任务执行和调试分析。通过遍历结果数组，可以区分成功与失败，并进行后续处理，例如筛选数据、统一错误处理或有条件重试。

Promise.allSettled用于处理多个Promise，无论成功或失败，都会等待全部完成并返回结果报告。1. 它接收一个Promise数组，返回一个在所有Promise落定后解决的新Promise；2. 返回值是一个数组，每个元素包含status（'fulfilled'或'rejected'）及对应value或reason；3. 与Promise.all不同，它不会因单个失败而中断；4. 适用于需要完整结果报告的场景，如批量操作、数据收集、非关键任务执行和调试分析；5. 处理结果时可通过遍历数组区分成功与失败，并进行后续操作，例如筛选数据、统一错误处理或有条件重试。

Promise.allSettled是一个非常有用的JavaScript异步操作工具，它能让你在处理一组Promise时，无论这些Promise是成功还是失败，都能等到它们全部完成，然后给你一个包含所有结果的报告。这意味着即使其中有Promise拒绝了，也不会像Promise.all那样立即中断，而是会继续等待所有操作都得出结论。

解决方案

在使用JavaScript处理多个并发异步任务时，我们常常需要等待所有任务都完成，无论它们的结果是成功还是失败。Promise.allSettled正是为这种场景而生。它接收一个Promise的可迭代对象（比如一个数组），然后返回一个新的Promise。这个新的Promise会在所有输入的Promise都“落定”（settled，即无论是fulfilled成功还是rejected失败）之后才解决。解决后的值是一个数组，数组中的每个元素都是一个对象，描述了对应Promise的最终状态。

每个结果对象都有一个status属性，可能是'fulfilled'或'rejected'。如果状态是'fulfilled'，对象会有一个value属性，包含该Promise的成功值；如果状态是'rejected'，则会有一个reason属性，包含该Promise的拒绝原因。这种设计使得我们能够清晰地知道每一个异步操作的最终结果，而不会因为某个操作的失败而丢失其他操作的信息。

举个例子，假设你要同时向多个不同的API端点发起请求，并且你希望无论哪个请求失败，都能拿到所有请求的最终状态：

const fetchUserData = () => new Promise(resolve => setTimeout(() => resolve({ id: 1, name: 'Alice' }), 1000));
const fetchProductData = () => new Promise((_, reject) => setTimeout(() => reject(new Error('Product API failed')), 1500));
const fetchOrderData = () => new Promise(resolve => setTimeout(() => resolve({ orderId: 'ABC', total: 120 }), 800));

async function getAllDataOutcomes() {
    const results = await Promise.allSettled([
        fetchUserData(),
        fetchProductData(),
        fetchOrderData()
    ]);

    console.log(results);
    // 预期输出类似：
    // [
    //   { status: 'fulfilled', value: { id: 1, name: 'Alice' } },
    //   { status: 'rejected', reason: Error: Product API failed },
    //   { status: 'fulfilled', value: { orderId: 'ABC', total: 120 } }
    // ]

    results.forEach((result, index) => {
        if (result.status === 'fulfilled') {
            console.log(`Promise ${index + 1} succeeded with value:`, result.value);
        } else {
            console.error(`Promise ${index + 1} failed with reason:`, result.reason);
        }
    });
}

getAllDataOutcomes();

这个例子清楚地展示了Promise.allSettled如何让你在所有操作完成后，统一地检查并处理每个操作的结果，无论成功与否。

Promise.allSettled与Promise.all和Promise.race有何不同？

这三者在处理Promise集合时各有侧重，理解它们的差异是掌握异步编程的关键。对我来说，最直观的区分点在于它们对“失败”的态度。

Promise.all是“全有或全无”的策略。它期望所有传入的Promise都能成功。一旦其中任何一个Promise被拒绝（rejected），Promise.all返回的Promise就会立即拒绝，并把第一个拒绝的原因作为其拒绝值。这意味着，如果你有十个并发请求，其中一个失败了，那么你根本不会知道其他九个请求是成功了还是还在进行中，因为整个Promise.all操作已经提前结束了。这在某些场景下很有用，比如你所有的操作都必须成功才能继续下一步，任何一个失败都意味着整个流程的失败。

Promise.race则像是一场赛跑。它会等待传入的Promise集合中第一个“落定”（无论是成功还是失败）的Promise。一旦有Promise成功解决了，Promise.race就成功解决；一旦有Promise拒绝了，Promise.race就立即拒绝。它只关心“最快”的结果，而不关心其他Promise的状态。这在超时控制或多个数据源竞争的场景中非常有用，比如你从多个服务器请求相同的数据，只取最快响应的那个。

而Promise.allSettled则完全不同，它有点像一个负责任的家长，会等待所有孩子（Promise）都完成各自的事情（无论是考上大学还是创业失败），然后才给你一份完整的报告。它不会因为某个Promise的失败而中断整个等待过程。它的核心价值在于“收集所有结果”，即使有些结果是错误信息。这对于需要进行完整审计、日志记录或在UI上展示所有操作状态的场景来说，简直是量身定制。比如，你批量上传文件，你可能想知道哪些文件上传成功了，哪些失败了，以及失败的原因，而不是一失败就中断整个批处理。

什么时候应该优先考虑使用Promise.allSettled？

在我的实际开发经验中，Promise.allSettled经常在那些“部分成功也算成功，但需要知道所有细节”的场景中大放异彩。它特别适合以下几种情况：

1. 批量操作且需要完整报告：当你执行一组相互独立的任务时，比如同时更新用户配置的多个字段，或者向多个分析服务发送数据。即使其中一个操作失败了，你也不希望整个流程中断，而是想知道每个操作的具体结果，以便进行后续处理（例如，重试失败的，或给用户反馈哪些成功了，哪些失败了）。如果你用Promise.all，一个字段更新失败就会导致整个操作失败，你无法直接获取其他字段的更新结果。

2. 数据收集与容错：假设你正在从多个不相关的API获取数据，用于填充UI的不同部分。例如，一个页面需要显示用户基本信息、订单列表和最近的活动。如果订单API暂时不可用，你仍然希望能够显示用户基本信息和活动，而不是整个页面都加载失败。使用Promise.allSettled，你可以独立地处理每个数据源的结果，即使某个API调用失败，其他成功的数据也能正常展示。

3. 非关键性任务的并行执行：有些任务不是核心业务流程的一部分，但仍然有价值，比如日志记录、缓存更新、发送通知等。你可以将它们与核心业务逻辑并行执行，使用Promise.allSettled来确保它们都被尝试执行，并且你可以事后检查它们的执行状态，而不会影响主流程的响应时间或稳定性。

4. 调试和错误分析：在开发或调试阶段，当你需要了解一组并发操作中每一个操作的详细情况时，Promise.allSettled提供了非常直接的手段。它返回的结构化结果让你能够轻松地识别哪些操作成功了，哪些失败了，以及失败的具体原因，这对于定位问题非常有帮助。

简单来说，当你需要“无论如何，都要给我所有结果”的时候，Promise.allSettled就是你的首选。它提供了一种优雅的方式来处理并发任务中的部分失败，同时保持对所有任务状态的可见性。

如何处理Promise.allSettled返回的结果？

处理Promise.allSettled返回的结果，核心在于遍历那个包含状态对象的数组，并根据每个对象的status属性来区分成功和失败。

返回的数组中，每个元素都是一个形如{ status: 'fulfilled', value: any }或{ status: 'rejected', reason: any }的对象。所以，处理它的方式通常会涉及一个循环和条件判断。

async function processAllOutcomes(promises) {
    const results = await Promise.allSettled(promises);

    const successfulResults = [];
    const failedResults = [];

    results.forEach((item, index) => {
        if (item.status === 'fulfilled') {
            successfulResults.push({ index, value: item.value });
            console.log(`操作 ${index} 成功:`, item.value);
        } else {
            failedResults.push({ index, reason: item.reason });
            console.error(`操作 ${index} 失败:`, item.reason);
        }
    });

    console.log('\n--- 汇总报告 ---');
    if (successfulResults.length > 0) {
        console.log('成功完成的操作:', successfulResults);
    } else {
        console.log('没有操作成功。');
    }

    if (failedResults.length > 0) {
        console.log('失败的操作:', failedResults);
        // 这里可以进一步处理失败，比如重试、记录日志或向用户显示错误消息
    } else {
        console.log('所有操作均成功完成！');
    }

    return { successfulResults, failedResults };
}

// 示例调用
const p1 = Promise.resolve('Data A');
const p2 = Promise.reject(new Error('Network Error'));
const p3 = new Promise(resolve => setTimeout(() => resolve('Data B'), 500));

processAllOutcomes([p1, p2, p3]);

在这个例子中，我们迭代了results数组，并根据item.status来判断是成功还是失败。我们甚至可以进一步将成功和失败的结果分别收集起来，以便后续的批量处理。

更进一步，你可以根据业务需求，对这些结果进行复杂的后处理：

• 筛选并聚合成功数据：如果你需要从所有成功的操作中提取特定数据，可以利用map或filter等数组方法。

  const fulfilledValues = results
      .filter(item => item.status === 'fulfilled')
      .map(item => item.value);
  console.log('所有成功获取的值:', fulfilledValues);

• 统一错误处理：你可以收集所有失败的原因，然后统一上报到错误监控系统，或者在UI上显示一个包含所有错误信息的弹窗。

  const rejectedReasons = results
      .filter(item => item.status === 'rejected')
      .map(item => item.reason);
  if (rejectedReasons.length > 0) {
      console.error('发现以下错误:', rejectedReasons);
      // 上报到Sentry或Loggly
  }

• 有条件地重试：对于某些可重试的错误（例如网络超时），你可以在收集到所有失败结果后，只对这些特定的失败进行重试操作。

这种结果处理模式赋予了开发者极大的灵活性，能够根据实际场景，精细地控制和响应每一个异步操作的最终状态。

今天关于《Promise.allSettled方法详解与使用教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！