Promise 官方

介绍

Promise，译为承诺，是异步编程的一种解决方案，比传统的解决方案（回调函数）更加合理和更加强大，避免了回调地狱的问题，提高了代码的可读性、可维护性和性能，同时提供了更好的错误处理和代码组织机制。

参数

Promise的参数是一个函数，这个函数接收两个参数：__ resolve和reject__。这两个参数都是函数，其中resolve代表成功，reject代表失败（选填）。

const myPromise = new Promise((resolve, reject) => {
  setTimeout(() => {
    // resolve("成功的结果");
    // reject("失败的结果");
  }, 300);
});

状态

Promise对象的状态不受外界影响。
Promise有三种状态：pending（进行中）、fulfilled（已成功）和rejected（已失败）。
一旦状态改变，就不会再变，任何时候Promise都只有一种状态。
一旦状态改变，Promise就无法取消。这意味着一旦新建它就会立即执行，无法中途取消。

方法

1. 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'
})

2. 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
});

3. 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(() => {
  // 这个肯定执行
});

4. 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']
});

5. 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'
});

6. any(): 用于等待第一个完成的Promise实例。

* 这个方法类似于`Promise.all`，但它返回一个新的Promise，当数组中的任意一个Promise实例完成（无论是fulfilled还是rejected）时，这个新的Promise就会完成。
*如果所有的Promise都被rejected，新的Promise将返回一个AggregateError。这个方法在处理多个并发的异步操作，并且希望在任意一个操作成功后继续执行后续操作时非常有用。
*注意：这个方法在ES2021规范中才被添加到JavaScript标准中。在较早版本的规范中可能不可用。

7. allSettled()

这个方法类似于Promise.all，但它返回一个新的Promise，当所有的Promise实例都完成（无论是fulfilled还是rejected）时，这个新的Promise才会完成。它返回一个数组，包含所有完成（无论是fulfilled还是rejected）的Promise的结果。每个结果都是一个对象，包含状态（状态是"fulfilled"或"rejected"）和值（如果是fulfilled则为结果，如果是rejected则为错误）

8. resolve()
9. reject()