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() 方法的参数具有很大的灵活性,可以适应多种不同的场景和需求,方便地处理多个异步操作的并发执行和结果汇总。