Promise.all()
和 Promise.race()
是 JavaScript 中处理 Promise 的两个不同方法。它们的主要区别在于如何处理输入的 Promise 以及返回的 Promise 的解决或拒绝方式。以下是对这两者的详细比较:
一、Promise.all()
1. 功能
Promise.all()
接受一个可迭代对象(通常是数组)作为参数,并返回一个新的 Promise。- 该 Promise 只有在所有输入的 Promise 都成功时才会解决,并返回一个包含所有结果的数组。
- 如果任何一个输入的 Promise 被拒绝,返回的 Promise 会立即被拒绝,并返回该拒绝的错误。
2. 示例
const promise1 = Promise.resolve(1);
const promise2 = Promise.resolve(2);
const promise3 = Promise.reject(new Error('Failure'));
Promise.all([promise1, promise2, promise3])
.then(results => {
console.log(results); // 不会被调用
})
.catch(error => {
console.error(error.message); // 输出: "Failure"
});
在这个例子中,由于 promise3
被拒绝,Promise.all
立即拒绝。
二、Promise.race()
1. 功能
Promise.race()
也接受一个可迭代对象(通常是数组)作为参数,并返回一个新的 Promise。- 该 Promise 会在第一个输入的 Promise 完成(无论是解决还是拒绝)时解决或拒绝,并返回该 Promise 的结果或错误。
2. 示例
const promise1 = new Promise(resolve => setTimeout(() => resolve('First'), 200));
const promise2 = new Promise(resolve => setTimeout(() => resolve('Second'), 100));
const promise3 = new Promise((_, reject) => setTimeout(() => reject(new Error('Failure')), 150));
Promise.race([promise1, promise2, promise3])
.then(result => {
console.log(result); // 输出: "Second" (因为它是第一个解决的 Promise)
})
.catch(error => {
console.error(error.message); // 不会被调用
});
在这个例子中,promise2
是第一个解决的 Promise,因此 Promise.race
返回的 Promise 解决为 'Second'
。
三、主要区别总结
特性 | Promise.all() | Promise.race() |
---|---|---|
返回的 Promise 状态 | 只有在所有 Promise 成功时才解决 | 在第一个 Promise 完成时(成功或失败)解决 |
处理失败的方式 | 任何一个 Promise 失败则立即拒绝 | 只要有一个 Promise 完成,就返回该 Promise 的结果 |
返回的结果 | 包含所有成功 Promise 的结果数组 | 返回第一个完成的 Promise 的结果或错误 |
四、使用场景
-
使用
Promise.all()
:- 当需要等待多个异步操作都完成,并且希望在所有操作都成功后处理结果时,例如并行处理 API 请求。
-
使用
Promise.race()
:- 当只关心第一个完成的 Promise 时,例如实现超时机制,或者当你只需要一个快速的响应,而忽略其他 Promise 的结果。