【JavaScript】Promise.all 静态方法详解

在现代 JavaScript 编程中，异步操作已经成为不可或缺的一部分，而 Promise.all 方法则是处理多个异步任务时的强大工具。它允许我们并行执行多个异步操作，并且在所有操作完成后处理它们的结果。本文将详细介绍 Promise.all 的作用、使用场景、工作原理，以及如何避免常见的陷阱。

一、Promise.all 简介

1. 方法介绍

Promise.all 是 JavaScript 中 Promise 对象的一个静态方法，专门用于处理多个并发的异步操作。它接收一个可迭代对象（通常是数组）作为参数，这个参数中包含多个 Promise 对象，并返回一个新的 Promise。当所有的 Promise 都成功时，新返回的 Promise 会被解决（fulfilled），其值是一个包含所有输入 Promise 结果的数组；如果其中有任何一个 Promise 失败，则新返回的 Promise 会被拒绝（rejected），并返回第一个被拒绝的 Promise 的错误信息。

2. 适用场景

• 并行执行异步操作：当我们需要同时发起多个异步请求，并且只有在所有请求都完成后才需要处理数据时，Promise.all 是一个非常有效的工具。
• 合并结果：它可以将多个异步操作的结果合并为一个数组，便于后续处理。
• 依赖数据处理：有时我们需要等待多个异步任务完成后才能进行后续操作，Promise.all 是最合适的解决方案。

二、Promise.all 的基本用法

1. 基本语法

Promise.all(iterable);

• iterable 是一个可迭代对象，通常是包含多个 Promise 的数组。
• 返回值是一个新的 Promise，该 Promise 会在所有输入的 Promise 都完成时解决，或者在其中一个 Promise 被拒绝时拒绝。

2. 示例代码

const promise1 = Promise.resolve(3);
const promise2 = 42;
const promise3 = new Promise((resolve, reject) => {
  setTimeout(resolve, 100, 'foo');
});

Promise.all([promise1, promise2, promise3]).then((values) => {
  console.log(values); // [3, 42, "foo"]
});

在这个例子中，Promise.all 等待三个 Promise（promise1，promise2 和 promise3）完成，并将它们的结果组合成一个数组返回。

三、Promise.all 的工作原理

1. 并行执行

Promise.all 方法会并行执行数组中的所有 Promise 对象，不会按照顺序依次等待它们完成。这意味着即使其中某个 Promise 需要较长时间才能完成，其他 Promise 仍会同时进行。这使得 Promise.all 成为处理并发任务的最佳选择。

2. 结果返回顺序

尽管 Promise.all 中的 Promise 是并行执行的，但返回结果的顺序与传入 Promise 的顺序一致。也就是说，即使第一个 Promise 需要更长的时间完成，最终返回的数组中，它的结果仍然会排在第一位。

3. 拒绝处理

如果传入的 Promise 数组中有一个 Promise 被拒绝，那么 Promise.all 返回的 Promise 也会立即被拒绝，并抛出该拒绝的错误。此时，其他尚未完成的 Promise 不会被等待。

拒绝示例

const promise1 = Promise.resolve(3);
const promise2 = new Promise((resolve, reject) => setTimeout(reject, 100, 'Error'));
const promise3 = Promise.resolve('foo');

Promise.all([promise1, promise2, promise3])
  .then((values) => console.log(values))
  .catch((error) => console.log(error)); // 输出 "Error"

在这个例子中，尽管 promise1 和 promise3 都成功解决，但因为 promise2 被拒绝，整个 Promise.all 直接被拒绝，并抛出了 promise2 的错误。

四、Promise.all 的实际应用

1. 并发请求

Promise.all 经常用于处理多个并发的网络请求。例如，在一个应用程序中，我们可能需要同时获取多个 API 的数据，然后将这些数据结合起来处理。使用 Promise.all 可以显著提升性能，因为它允许所有请求并行执行，而不必等待每个请求依次完成。

const getData1 = fetch('https://api.example.com/data1');
const getData2 = fetch('https://api.example.com/data2');
const getData3 = fetch('https://api.example.com/data3');

Promise.all([getData1, getData2, getData3])
  .then((responses) => Promise.all(responses.map((response) => response.json())))
  .then((data) => console.log(data))
  .catch((error) => console.error('Error fetching data:', error));

2. 处理依赖任务

在某些情况下，我们可能需要同时执行多个依赖于彼此的数据请求，例如当不同的 API 数据组合成一个新的数据结构时，Promise.all 是最合适的选择。

const getUser = fetch('https://api.example.com/user');
const getOrders = fetch('https://api.example.com/orders');

Promise.all([getUser, getOrders])
  .then(([userResponse, ordersResponse]) => Promise.all([userResponse.json(), ordersResponse.json()]))
  .then(([userData, ordersData]) => {
    // 使用用户数据和订单数据进行某些处理
    console.log('User:', userData);
    console.log('Orders:', ordersData);
  })
  .catch((error) => console.error('Error:', error));

在这个例子中，我们同时获取用户信息和订单信息，并在它们都完成后进行进一步处理。

五、常见问题与最佳实践

1. Promise.all 不等待所有任务完成

Promise.all 的一个常见问题是，如果任何一个 Promise 失败，整个 Promise.all 会立即被拒绝，而不会等待其他 Promise 完成。这在某些情况下可能不是我们期望的行为。要解决这个问题，可以为每个 Promise 添加错误处理，以确保即使某个 Promise 失败，其他 Promise 仍然可以继续执行。

const promise1 = Promise.resolve(3);
const promise2 = new Promise((resolve, reject) => setTimeout(reject, 100, 'Error'));
const promise3 = Promise.resolve('foo');

Promise.all([promise1, promise2.catch((e) => e), promise3])
  .then((values) => console.log(values)) // 输出 [3, "Error", "foo"]
  .catch((error) => console.log(error));

在这个例子中，我们使用 promise2.catch 捕获了 promise2 的错误，从而确保其他 Promise 的结果仍然会被返回。

2. 避免 Promise.all 阻塞 UI

在处理多个耗时任务时，Promise.all 可能会导致 UI 阻塞，影响用户体验。为了解决这个问题，可以考虑将任务拆分为更小的部分，或者使用 Promise.allSettled，它会等待所有 Promise 完成，不论它们是成功还是失败。

Promise.allSettled([promise1, promise2, promise3])
  .then((results) => results.forEach((result) => console.log(result.status)));

Promise.allSettled 返回一个数组，数组中的每个元素表示对应的 Promise 是成功还是失败。

六、总结

Promise.all 是 JavaScript 中处理多个并发异步操作的强大工具，它不仅提高了程序的执行效率，还提供了清晰的结果管理方式。通过正确使用 Promise.all，我们可以编写更加简洁高效的代码，并减少回调地狱的出现。不过，在使用时也需要注意异常处理，避免因为单个 Promise 的失败而导致整个任务组的失败。希望本文对你理解和使用 Promise.all 有所帮助。

推荐：

• JavaScript
• react
• vue

---