Promise.all()
方法的参数可以是多种数据类型,以下是详细介绍:
1. 数组
这是最常见也是最直观的一种形式。将多个 Promise
对象以数组的形式作为 Promise.all()
的参数。例如:
const promise1 = new Promise((resolve) => setTimeout(() => resolve('数据 1'), 1000));
const promise2 = new Promise((resolve) => setTimeout(() => resolve('数据 2'), 2000));
const promise3 = new Promise((resolve) => setTimeout(() => resolve('数据 3'), 1500));
Promise.all([promise1, promise2, promise3])
.then((results) => {
console.log('所有请求都成功,结果为:', results);
})
.catch((error) => {
console.log('有请求失败,错误为:', error);
});
在这个例子中,数组中的每个元素都是一个 Promise
对象,它们会并行执行,Promise.all()
会等待所有 Promise
都完成并将结果以数组的形式返回。
2. 类数组对象
除了普通数组,一些类数组对象也可以作为 Promise.all()
的参数。这些类数组对象通常具有 length
属性和可索引的元素。比如 arguments
对象。
function getData() {
const promiseA = new Promise((resolve) => setTimeout(() => resolve('A 数据'), 1200));
const promiseB = new Promise((resolve) => setTimeout(() => resolve('B 数据'), 1000));
const promiseC = new Promise((resolve) => setTimeout(() => resolve('C 数据'), 1500));
return Promise.all(arguments);
}
getData(promiseA, promiseB, promiseC)
.then((results) => {
console.log('所有请求都成功,结果为:', results);
})
.catch((error) => {
console.log('有请求失败,错误为:', error);
});
3. 可迭代对象
ES6 中的一些可迭代对象,如 Set
、Map
等,也可以作为 Promise.all()
的参数。
const promiseSet = new Set([
new Promise((resolve) => setTimeout(() => resolve('集合数据 1'), 1300)),
new Promise((resolve) => setTimeout(() => resolve('集合数据 2'), 1100)),
new Promise((resolve) => setTimeout(() => resolve('集合数据 3'), 1400))
]);
Promise.all(promiseSet)
.then((results) => {
console.log('所有请求都成功,结果为:', results);
})
.catch((error) => {
console.log('有请求失败,错误为:', error);
});
Promise.all()
会遍历可迭代对象中的每个元素,如果元素是 Promise
对象,则会等待其状态变化;如果元素不是 Promise
对象,则会将其视为已经完成的 Promise
,并将其本身作为结果。
4. 包含 Promise
和非 Promise
值的混合对象
参数中还可以同时包含 Promise
对象和其他非 Promise
值,如字符串、数字等。
const promiseX = new Promise((resolve) => setTimeout(() => resolve('X 数据'), 1200));
const valueY = 'Y 数据';
const promiseZ = new Promise((resolve) => setTimeout(() => resolve('Z 数据'), 1400));
Promise.all([promiseX, valueY, promiseZ])
.then((results) => {
console.log('所有请求都成功,结果为:', results);
})
.catch((error) => {
console.log('有请求失败,错误为:', error);
});
在这种情况下,非 Promise
值会被视为已经完成的 Promise
,其值会直接作为结果数组中的对应元素。Promise.all()
仍然会等待所有的 Promise
对象都变为完成状态后才返回最终结果。如果 Promise
对象中有一个失败,则整个操作失败,并将第一个失败的 Promise
的错误信息传递给 .catch()
方法。
综上所述,Promise.all()
方法的参数具有很大的灵活性,可以适应多种不同的场景和需求,方便地处理多个异步操作的并发执行和结果汇总。