Promise笔记

笔记源于阮一峰《ECMAScript 6 入门教程》

Promise.prototype.then()：为 Promise 实例添加状态改变时的回调函数。then方法的第一个参数是resolved状态的回调函数，第二个参数是rejected状态的回调函数，它们都是可选的。

Promise.prototype.catch()：是.then(null, rejection)或.then(undefined, rejection)的别名，用于指定发生错误时的回调函数。Promise 对象的错误具有“冒泡”性质，会一直向后传递，直到被捕获为止。也就是说，错误总是会被下一个catch语句捕获。没有使用catch()方法指定错误处理的回调函数，Promise 对象抛出的错误不会传递到外层代码。

Promise.prototype.finally()：ES2018 引入。用于指定不管 Promise 对象最后状态如何，都会执行的操作。

Promise.all()：用于将多个 Promise 实例p*，包装成一个新的 Promise 实例p1。只有p的状态全部变成fulfilled，p1状态才会变成fulfilled；若p任意一个状态变成rejected，p1状态变成rejected，此时的reject的实例返回值会传递给p1，结束。若p有自己的catch()方法，prejected执行完catch()后，也会变成resolved;导致Promise.all()的catch()不能捕获到p*的异常。

Promise.race()：将多个 Promise 实例p*，包装成一个新的 Promise 实例p1。p*有一个实例率先改变状态，p的状态就跟着改变。那个率先改变的 Promise 实例的返回值，就传递给p的回调函数。

Promise.allSettled()：ES2020 引入。将多个 Promise 实例p*，包装成一个新的 Promise 实例p1。不管每一个操作是成功还是失败，再进行下一步操作。该方法返回的新的 Promise 实例，一旦发生状态变更，状态总是fulfilled，不会变成rejected。状态变成fulfilled后，它的回调函数会接收到一个数组作为参数，该数组的每个成员对应前面数组的每个 Promise 对象。

// 异步操作成功时
{status: 'fulfilled', value: value}

// 异步操作失败时
{status: 'rejected', reason: reason}

Promise.any() ：ES2021 引入。接受一组 Promise 实例作为参数，包装成一个新的 Promise 实例p1返回。只要p实例有一个变成fulfilled状态，p1实例就会变成fulfilled状态；如果p实例都变成rejected状态，p1实例就会变成rejected状态。Promise.any()抛出的错误，不是一个一般的 Error 错误对象，而是一个 AggregateError 实例。它相当于一个数组，每个成员对应一个被rejected的操作所抛出的错误。

Promise.resolve()：Promise.resolve(value)方法也会返回一个新的 Promise 实例，该实例的状态为resolved。立即resolve()的 Promise 对象，是在本轮“事件循环”（event loop）的结束时执行，而不是在下一轮“事件循环”的开始时。

setTimeout(function () {   console.log('three'); }, 0);

Promise.resolve().then(function () {   console.log('two'); });

console.log('one');

// one // two // three

Promise.reject()：Promise.reject(reason)方法也会返回一个新的 Promise 实例，该实例的状态为rejected。

Promise.try() ：catch()不能捕获同步错误，这时需要使用try…catch捕获。

try {
  new Promise((resolve,rejected)=>{})
  .then(...)
  .catch(...)
} catch (e) {
  // ...
}

可以统一用promise.catch()捕获所有同步和异步的错误。

Promise.try(() =>  new Promise((resolve,rejected)=>{}))
  .then(...)
  .catch(...)