Promise 官方
介绍
Promise,译为承诺,是异步编程的一种解决方案,比传统的解决方案(回调函数)更加合理和更加强大,避免了回调地狱的问题,提高了代码的可读性、可维护性和性能,同时提供了更好的错误处理和代码组织机制。
参数
Promise的参数是一个函数,这个函数接收两个参数:__ resolve和reject__。这两个参数都是函数,其中resolve代表成功,reject代表失败(选填)。
const myPromise = new Promise((resolve, reject) => {
setTimeout(() => {
// resolve("成功的结果");
// reject("失败的结果");
}, 300);
});
状态
Promise对象的状态不受外界影响。
Promise有三种状态:pending(进行中)、fulfilled(已成功)和rejected(已失败)。
一旦状态改变,就不会再变,任何时候Promise都只有一种状态。
一旦状态改变,Promise就无法取消。这意味着一旦新建它就会立即执行,无法中途取消。
方法
- then(): 用于指定Promise完成时的回调函数和Promise拒绝时的回调函数。
* 第一个回调函数是Promise对象的状态变为resolved时调用,回调函数的参数是Promise的结果。
* 第二个回调函数是Promise对象的状态变为rejected时调用,回调函数的参数是Promise的错误对象。
* 返回一个新的Promise对象,可以通过then方法链式调用。
// then方法示例
let promise1 = new Promise((resolve, reject) => {
setTimeout(resolve, 1000, 'one');
});
promise1.then(result => {
console.log(result); // 'one'
})
- catch(): 用于指定发生错误时的回调函数。
* 返回一个新的Promise对象,所以也可以通过catch方法链式调用。
// catch方法示例
let promise2 = new Promise((resolve, reject) => {
setTimeout(reject, 1000, new Error('error'));
});
promise2.then(result => {
console.log(result);
}).catch(error => {
console.log(error); // Error: error
});
- finally(): 用于指定不管Promise最后状态如何,都会执行的回调函数。
* finally方法中的回调函数将在Promise对象的状态确定之后执行,无论状态是fulfilled还是rejected。
* 返回一个新的Promise对象,所以也可以通过finally方法链式调用。
* 这个方法不接受任何参数,因此在finally函数中无法访问Promise的结果或错误。
let promise = new Promise((resolve, reject) => {
// some async operation
});
promise..then(result => {
console.log(result);
}).catch(error => {
console.log(error);
}).finally(() => {
// 这个肯定执行
});
- all(): 用于等待所有的Promise实例都完成。
* all方法接受一个Promise实例数组作为参数。
* 当所有的Promise实例都完成时,返回一个新的Promise实例,它的结果是一个数组,包含了所有Promise实例的结果。
let promise1 = new Promise((resolve, reject) => {
setTimeout(resolve, 1000, 'one');
});
let promise2 = new Promise((resolve, reject) => {
setTimeout(resolve, 2000, 'two');
});
Promise.all([promise1, promise2]).then(results => {
console.log(results); // ['one', 'two']
});
- race(): 用于等待第一个完成的Promise实例。
* race方法接受一个Promise实例数组作为参数。
* 当第一个Promise实例完成时(无论是成功还是失败),就返回一个新的Promise实例,它的结果就是第一个Promise实例的结果。
let promise1 = new Promise((resolve, reject) => {
setTimeout(resolve, 1000, 'one');
});
let promise2 = new Promise((resolve, reject) => {
setTimeout(resolve, 2000, 'two');
});
Promise.race([promise1, promise2]).then(result => {
console.log(result); // could be 'one' or 'two'
});
- any(): 用于等待第一个完成的Promise实例。
* 这个方法类似于`Promise.all`,但它返回一个新的Promise,当数组中的任意一个Promise实例完成(无论是fulfilled还是rejected)时,这个新的Promise就会完成。
*如果所有的Promise都被rejected,新的Promise将返回一个AggregateError。这个方法在处理多个并发的异步操作,并且希望在任意一个操作成功后继续执行后续操作时非常有用。
*注意:这个方法在ES2021规范中才被添加到JavaScript标准中。在较早版本的规范中可能不可用。
- allSettled()
这个方法类似于Promise.all,但它返回一个新的Promise,当所有的Promise实例都完成(无论是fulfilled还是rejected)时,这个新的Promise才会完成。它返回一个数组,包含所有完成(无论是fulfilled还是rejected)的Promise的结果。每个结果都是一个对象,包含状态(状态是"fulfilled"或"rejected")和值(如果是fulfilled则为结果,如果是rejected则为错误)
- resolve()
- reject()