ES6 中的 Promise.any 方法详解-JavaScript中文网-JavaScript教程资源分享门户

Promise.any() 是 ES6 中新增的方法，用于同步或异步地执行一系列 Promise，只要其中任何一个 Promise 成功就会返回其结果，无需等待其他 Promise 的执行结果。在本文中，我们将深入探讨 Promise.any() 的特性和用法，帮助读者更好地理解和应用这一功能。

Promise.any 方法的基本语法和用法

Promise.any() 方法的语法如下：

Promise.any(iterable);

其中，iterable 是一个可迭代对象，它由多个 Promise 对象构成。

当 iterable 中的任意一个 Promise 成功时，Promise.any() 就会返回一个新的 Promise，它的状态会变成 fulfilled，并且值为该 Promise 的成功值。如果所有 Promise 都失败了，那么 Promise.any() 就会返回一个新的 Promise，它的状态会变成 rejected，而且值为所有 Promise 的失败原因的数组。

下面是一个简单的示例，它用 Promise.any() 方法来执行两个 Promise 实例：

const p1 = Promise.resolve(1);
const p2 = Promise.reject('error');
Promise.any([p1, p2])
  .then(value => console.log(value))
  .catch(error => console.log(error));

在上面的示例中，我们创建了两个 Promise 实例 p1 和 p2，p1 成功返回值 1，而 p2 失败并返回了一个字符串 'error'。接着，我们使用 Promise.any() 方法来执行这两个 Promise，并在控制台输出结果。

由于 p1 成功了，Promise.any() 就会返回一个新的 Promise，它的状态会变成 fulfilled，而且值为 p1 的成功值 1。因此，我们可以看到控制台输出了数字 1。

Promise.any 方法的特性和注意事项

接下来，我们将深入探讨 Promise.any() 方法的一些特性和注意事项，以更好地理解这一方法的用法和行为。

Promise.any() 只需要一个 Promise 成功

Promise.any() 方法只需要 iterable 中的一个 Promise 成功就会返回一个新的 Promise，而不需要所有 Promise 都成功。这与 Promise.all() 方法的表现形式截然不同。

例如，假设我们有一个包含 3 个 Promise 实例的数组：

const promises = [
  Promise.reject('error'),
  Promise.resolve(1),
  Promise.reject('rejected'),
];

接着，我们使用 Promise.any() 方法来执行这个数组中的所有 Promise，并输出结果：

Promise.any(promises)
  .then(value => console.log(value))
  .catch(error => console.log(error));

在上面的示例中，只要 iterable 中的任意一个 Promise 成功，Promise.any() 就会返回该 Promise 的成功值。因此，我们可以看到控制台输出了数字 1。

Promise.any() 忽略 rejected 状态的 Promise

在使用 Promise.any() 方法时，方法会忽略 rejected 状态的 Promise，只需要其中任何一个 Promise 成功就可以返回结果。

例如，在下面的示例中，我们创建了一个数组 promises，它包含 3 个 Promise 实例，全部返回 rejected 状态：

const promises = [
  Promise.reject('rejected'),
  Promise.reject('rejected'),
  Promise.reject('rejected'),
];

接着，我们使用 Promise.any() 方法来执行这个数组中的所有 Promise，并输出结果：

Promise.any(promises)
  .then(value => console.log(value))
  .catch(error => console.log(error));

在上面的示例中，由于 iterable 中没有任何一个 Promise 成功，Promise.any() 就会返回一个新的 Promise，它的状态会变成 rejected，而且值为所有 Promise 的失败原因的数组。因此，我们可以看到控制台输出了一个数组 ['rejected', 'rejected', 'rejected']。

返回的 Promise 对象是不实例化的

Promise.any() 方法返回的 Promise 对象并不是已经实例化的 Promise 对象，并且在调用 Promise.any() 方法后， iterable 中的 Promise 对象不会被实例化。这也可以避免出现一些不必要的副作用。

例如，在下面的示例中，我们创建了一个包含一万个 Promise 实例的数组，并使用 Promise.any() 方法来执行这个数组中的所有 Promise：

const promises = new Array(10000).fill(Promise.reject('rejected'));
Promise.any(promises);

在上面的示例中，任何一个 Promise 成功都可以结束整个过程，因此，这个示例中的任意一个 Promise 对象都没有被实例化。

如果所有 Promise 都失败，Promise.any() 将返回一个 AggregateError 对象

如果 iterable 中的所有 Promise 都失败，那么 Promise.any() 就会返回一个 AggregateError 对象，包含所有 Promise 的失败原因。

例如，在下面的示例中，我们创建了三个 Promise 实例，全部返回 rejected 状态：

const p1 = Promise.reject('rejected1');
const p2 = Promise.reject('rejected2');
const p3 = Promise.reject('rejected3');
Promise.any([p1, p2, p3]);

在上面的示例中，由于 iterable 中的所有 Promise 都失败了，Promise.any() 就会返回一个 AggregateError 对象，它包含了所有 Promise 的失败原因。

应用场景

Promise.any() 方法可以应用于多种场合，例如：

在某些条件满足时，只需要任意一个异步操作成功，就可以结束整个过程；
需要等待多个异步操作完成，但这些操作的完成时间不确定，而且可能会重试；
需要从多个 Promise 中获取数据，但有些 Promise 可能会失败，其他 Promise 仍然可以返回有效数据。

结论

Promise.any() 方法是一个非常有用且强大的工具，可以用来执行多个异步操作，并处理它们的结果。虽然它可以返回多种结果，但是在真实应用场景中，我们需要谨慎地使用它，以避免一些潜在的问题。

在开始使用 Promise.any() 方法之前，请务必仔细阅读本文并参考相关文档，以便更好地理解其特性和用法。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/674d6ccc11e808aa268a26aa

ES6 中的 Promise.any 方法详解