Promise有哪些实例方法

console.log(Object.getOwnPropertyDescriptors(Promise.prototype))

then方法

接受两个参数

• then方法是Promise对象上的一个方法:它其实是放在Promise的原型上的 Promise.prototype.then
  
• then方法接受两个参数:

• fulfilled的回调函数:当状态变成fulfilled时会回调的函数;
• reject的回调函数:当状态变成reject时会回调的函数;

多次调用

• 一个Promise的then方法是可以被多次调用的:

• 每次调用我们都可以传入对应的fulfilled回调;
• 当Promise的状态变成fulfilled的时候，这些回调函数都会被执行;

返回值

• then方法本身是有返回值的，它的返回值是一个Promise，所以我们可以进行如下的链式调用:

• 但是then方法返回的Promise到底处于什么样的状态呢?

• Promise有三种状态，那么这个Promise处于什么状态呢?

• 当then方法中的回调函数本身在执行的时候，那么它处于pending状态;
  
• 当then方法中的回调函数返回一个结果时，那么它处于fulfilled状态，并且会将结果作为resolve的参数;

• 情况一:返回一个普通的值;
• 情况二:返回一个Promise;
• 情况三:返回一个thenable值;

• 当then方法抛出一个异常时，那么它处于reject状态;
  

catch方法

多次调用

• catch方法也是Promise对象上的一个方法:它也是放在Promise的原型上的Promise.prototype.catch
  
• 一个Promise的catch方法是可以被多次调用的:

• 每次调用我们都可以传入对应的reject回调;
• 当Promise的状态变成reject的时候，这些回调函数都会被执行;

返回值

• 事实上catch方法也是会返回一个Promise对象的，所以catch方法后面我们可以继续调用then方法或者catch方法:

• 下面的代码，后续是catch中的err2打印，还是then中的res打印呢?
• 答案是res打印，这是因为catch传入的回调在执行完后，默认状态依然会是fulfilled的;

const promise = new Promise((resolve, reject) => {
  reject("111111")
})
promise.catch(err => {
  console.log("err1:", err)
}).catch(err2 => {
  console.log("err2:", err2)
}).then(res => {
  console.log("res result:", res)
})
// err1: 111111
// res result: undefined

• 那么如果我们希望后续继续执行catch，那么需要抛出一个异常:

const promise = new Promise((resolve, reject) => {
  reject("111111")
})
promise.then(res => {
  console.log("res:", res)
}).catch(err => {
  console.log("err:", err)
  throw new Error("catch return value")
}).then(res => {
  console.log("res result:", res)
}).catch(err => {
  console.log("err result:", err)
})
// err: 111111
// err result: Error: catch return value

finally方法

• finally是在ES9(ES2018)中新增的一个特性:表示无论Promise对象无论变成fulfilled还是reject状态，最终都会 被执行的代码。
  
• finally方法是不接收参数的，因为无论前面是fulfilled状态，还是reject状态，它都会执行。
  

代码演示

const promise = new Promise((resolve, reject) => {
  // resolve("resolve message")
  reject("reject message")
})
promise.then(res => {
  console.log("res:", res)
}).catch(err => {
  console.log("err:", err)
}).finally(() => {
  console.log("finally code execute")
})