Promise.allSettled 的错误容忍处理

在ES11（ECMAScript 2020）中，JavaScript引入了一个强大的Promise组合器——Promise.allSettled()，它解决了传统Promise.all()在处理多个异步操作时的一个关键痛点：错误容忍性。本文将深入探讨Promise.allSettled的工作原理、使用场景以及它如何改进异步编程中的错误处理策略。

Promise.allSettled 的基本概念

Promise.allSettled方法接收一个Promise数组作为输入，并返回一个新的Promise。与Promise.all不同，Promise.allSettled会等待所有Promise完成（无论是fulfilled还是rejected），而不会因为其中一个Promise被拒绝而提前终止。

javascript 复制代码

const promises = [
  Promise.resolve('成功1'),
  Promise.reject('失败1'),
  Promise.resolve('成功2'),
  Promise.reject('失败2')
];

Promise.allSettled(promises)
  .then(results => {
    results.forEach((result, index) => {
      if (result.status === 'fulfilled') {
        console.log(`Promise ${index}: 成功`, result.value);
      } else {
        console.log(`Promise ${index}: 失败`, result.reason);
      }
    });
  });

与传统Promise.all的对比

Promise.all的主要限制在于它的"全有或全无"特性：

如果所有Promise都成功解决，返回一个包含所有结果的数组
如果任何一个Promise被拒绝，立即拒绝并返回第一个错误

javascript 复制代码

// 使用Promise.all
Promise.all(promises)
  .then(results => console.log('所有都成功', results))
  .catch(error => console.log('遇到第一个错误', error)); 
  // 只要有一个失败，立即进入catch

相比之下，Promise.allSettled提供了更细粒度的控制：

总是等到所有Promise完成（无论成功或失败）
返回一个包含每个Promise结果详细信息的数组

结果数据结构

Promise.allSettled返回的结果数组中，每个元素都是一个对象，包含：

status: "fulfilled" 或 "rejected"
value (当status为fulfilled时): Promise的解决值
reason (当status为rejected时): Promise的拒绝原因

javascript 复制代码

[
  { status: 'fulfilled', value: '成功1' },
  { status: 'rejected', reason: '失败1' },
  { status: 'fulfilled', value: '成功2' },
  { status: 'rejected', reason: '失败2' }
]

实际应用场景

1. 批量API请求处理

当需要向多个API端点发送请求并希望收集所有响应（包括失败的）时：

javascript 复制代码

const apiEndpoints = ['/user/1', '/user/2', '/user/invalid'];

Promise.allSettled(apiEndpoints.map(endpoint => 
  fetch(endpoint).then(res => res.json())
)).then(results => {
  const successfulData = results
    .filter(result => result.status === 'fulfilled')
    .map(result => result.value);
  
  const errors = results
    .filter(result => result.status === 'rejected')
    .map(result => result.reason);
  
  console.log('成功获取的数据:', successfulData);
  console.log('发生的错误:', errors);
});

2. 表单多字段验证

实现表单多字段验证时，可以收集所有验证错误而不仅仅返回第一个错误：

javascript 复制代码

function validateField(field) {
  return new Promise((resolve, reject) => {
    // 模拟异步验证
    setTimeout(() => {
      if (field.value.length >= field.minLength) {
        resolve(`${field.name} 验证通过`);
      } else {
        reject(`${field.name} 必须至少 ${field.minLength} 个字符`);
      }
    }, Math.random() * 1000);
  });
}

const fields = [
  { name: '用户名', value: 'john', minLength: 5 },
  { name: '密码', value: '1234', minLength: 6 },
  { name: '邮箱', value: 'john@example.com', minLength: 3 }
];

Promise.allSettled(fields.map(validateField))
  .then(results => {
    const errors = results
      .filter(result => result.status === 'rejected')
      .map(result => result.reason);
    
    if (errors.length > 0) {
      console.log('验证错误:', errors);
    } else {
      console.log('所有字段验证通过');
    }
  });

3. 并行任务处理

当执行多个独立任务且不希望一个任务的失败影响其他任务时：

javascript 复制代码

const tasks = [
  backupDatabase(),
  uploadLogs(),
  sendNotifications(),
  cleanupTempFiles()
];

Promise.allSettled(tasks)
  .then(results => {
    const failedTasks = results.filter(r => r.status === 'rejected');
    if (failedTasks.length > 0) {
      sendErrorReport(failedTasks.map(t => t.reason));
    }
    console.log('所有任务处理完成');
  });

错误处理策略

使用Promise.allSettled时，可以灵活地实现多种错误处理策略：

收集所有错误：分析所有失败的Promise以全面了解问题
部分成功处理：只处理成功的Promise结果，忽略失败的
阈值控制：当失败数量超过某个阈值时才视为整体失败

javascript 复制代码

// 阈值控制示例
Promise.allSettled(jobs)
  .then(results => {
    const successCount = results.filter(r => r.status === 'fulfilled').length;
    const failureCount = results.length - successCount;
    
    if (failureCount / results.length > 0.3) { // 失败率超过30%
      throw new Error('失败率过高');
    }
    
    return results
      .filter(r => r.status === 'fulfilled')
      .map(r => r.value);
  });

兼容性与polyfill

虽然ES2020已经广泛支持，但在旧环境中可能需要polyfill：

javascript 复制代码

if (!Promise.allSettled) {
  Promise.allSettled = function(promises) {
    return Promise.all(promises.map(p => 
      p.then(value => ({
        status: 'fulfilled',
        value
      })).catch(reason => ({
        status: 'rejected',
        reason
      }))
    ));
  };
}

总结

Promise.allSettled是ES2020中一个重要的异步编程工具，它提供了比Promise.all更灵活的错误处理能力。通过允许所有Promise完成并返回详细的状态信息，它使得开发者能够构建更健壮、更容错的异步代码。在处理多个独立异步操作、需要收集完整结果（包括失败的）或实现复杂错误处理逻辑时，Promise.allSettled是一个理想的选择。