在 JavaScript 中,Promise 是处理异步操作的强大工具。除了基本的 .then()
和 .catch()
方法外,Promise 还提供了一系列静态方法,这些方法可以帮助我们更方便地处理多个异步任务。本文将详细介绍这些静态方法,并通过实际案例展示它们的使用场景。
1. Promise.resolve(data)
Promise.resolve(data)
用于将一个值包装成一个状态为 fulfilled
的 Promise 对象。如果传入的值已经是 Promise 对象,则直接返回该 Promise 对象。
javascript
const promise = Promise.resolve(42);
promise.then((value) => {
console.log(value); // 42
});
2. Promise.reject(reason)
Promise.reject(reason)
用于创建一个状态为 rejected
的 Promise 对象。如果传入的值已经是 Promise 对象,则直接返回该 Promise 对象。
javascript
const promise = Promise.reject(new Error('出错了'));
promise.catch((error) => {
console.log(error.message); // "出错了"
});
3. Promise.all(任务数组)
Promise.all(任务数组)
用于处理多个 Promise 对象。它返回一个新的 Promise 对象,该对象在所有输入的 Promise 对象都成功完成时成功,否则失败。
javascript
const promises = [Promise.resolve(1), Promise.resolve(2), Promise.resolve(3)];
Promise.all(promises).then((results) => {
console.log(results); // [1, 2, 3]
});
如果任何一个 Promise 失败,Promise.all
会立即失败,并返回失败的原因。
javascript
const promises = [Promise.resolve(1), Promise.reject(new Error('出错了')), Promise.resolve(3)];
Promise.all(promises).then((results) => {
console.log(results); // 不会执行
}).catch((error) => {
console.log(error.message); // "出错了"
});
4. Promise.any(任务数组)
Promise.any(任务数组)
用于处理多个 Promise 对象。它返回一个新的 Promise 对象,该对象在任何一个输入的 Promise 对象成功完成时成功,否则失败。
javascript
const promises = [Promise.reject(new Error('1')), Promise.resolve(2), Promise.reject(new Error('3'))];
Promise.any(promises).then((result) => {
console.log(result); // 2
}).catch((error) => {
console.log(error.message); // 不会执行
});
如果所有 Promise 都失败,Promise.any
会失败,并返回一个包含所有失败原因的数组。
javascript
const promises = [Promise.reject(new Error('1')), Promise.reject(new Error('2')), Promise.reject(new Error('3'))];
Promise.any(promises).then((result) => {
console.log(result); // 不会执行
}).catch((errors) => {
console.log(errors); // [Error: "1", Error: "2", Error: "3"]
});
5. Promise.allSettled(任务数组)
Promise.allSettled(任务数组)
用于处理多个 Promise 对象。它返回一个新的 Promise 对象,该对象在所有输入的 Promise 对象都已成功,不会失败。
javascript
const promises = [Promise.resolve(1), Promise.reject(new Error('2')), Promise.resolve(3)];
Promise.allSettled(promises).then((results) => {
console.log(results);
// [
// { status: 'fulfilled', value: 1 },
// { status: 'rejected', reason: Error: "2" },
// { status: 'fulfilled', value: 3 }
// ]
});
6. Promise.race(任务数组)
Promise.race(任务数组)
用于处理多个 Promise 对象。它返回一个新的 Promise 对象,该对象在任何一个输入的 Promise 对象已决时立即已决,状态和值与第一个已决的 Promise 一致。
javascript
const promises = [Promise.resolve(1), Promise.reject(new Error('2')), Promise.resolve(3)];
Promise.race(promises).then((result) => {
console.log(result); // 1
}).catch((error) => {
console.log(error.message); // 不会执行
});