PromiseA+规范

PromiseA+规范

讲解PromiseA+规范前, 咱们先来了解一下这些术语, 以便在后续提到的时候有明确且统一的概念.

术语

1. promise 是一个有then方法的对象或者是函数，行为遵循本规范
2. thenable 是一个有then方法的对象或者是函数
3. value 是promise状态成功时的值，也就是resolve的参数, 包括各种数据类型, 也包括undefined/thenable或者是 promise
4. reason 是promise状态失败时的值, 也就是reject的参数, 表示拒绝的原因
5. exception 是一个使用throw抛出的异常值

规范

接下来分几部分来讲解PromiseA+规范.

Promise States

promise应该有三种状态. 要注意他们之间的流转关系.

1. pending

   1.1 初始的状态, 可改变.
   1.2 一个promise在resolve或者reject前都处于这个状态。
   1.3 可以通过 resolve -> fulfilled 状态;
   通过resolve方法将promise的pending状态转为fulfilled状态
   1.4 可以通过 reject -> rejected 状态;
   通过reject方法将promise的pending状态转为rejected状态

2. fulfilled

   2.1 最终态, 不可变.
   2.2 一个promise被resolve后会变成这个状态.
   2.3 必须拥有一个value值

3. rejected

   3.1 最终态, 不可变.
   3.2 一个promise被reject后会变成这个状态
   3.3 必须拥有一个reason

Tips: 总结一下, 就是promise的状态流转是这样的

pending -> resolve(value) -> fulfilled
pending -> reject(reason) -> rejected

看一下图, 可能会更清晰一点, https://www.processon.com/diagraming/606569d1e401fd13004977d2

promise的返回值：then()

promise返回then方法，then方法接收onFulfilled、 onRejected方法
promise应该提供一个then方法, 用来访问最终的结果, 无论是value还是reason. 语法：

promise.then(onFulfilled, onRejected)

1. 参数要求

   1.1 onFulfilled 必须是函数类型, 如果不是函数, 应该被忽略.
   1.2 onRejected 必须是函数类型, 如果不是函数, 应该被忽略.

2. onFulfilled 特性

   2.1 在promise变成 fulfilled 时，应该调用 onFulfilled, 参数是value
   2.2 在promise变成 fulfilled 之前, 不应该被调用.
   2.3 只能被调用一次(所以在实现的时候需要一个变量来限制执行次数)

3. onRejected 特性

   3.1 在promise变成 rejected 时，应该调用 onRejected, 参数是reason
   3.2 在promise变成 rejected 之前, 不应该被调用.
   3.3 只能被调用一次(所以在实现的时候需要一个变量来限制执行次数)

4. onFulfilled 和 onRejected 应该是微任务

   这里用queueMicrotask来实现微任务的调用.

   事件循环执行到微任务时，会把微任务放入微任务队列，待到执行栈代码执行完毕之后才会执行微软栈中的内容；因此使用了html的微任务apiqueueMicrotask将resolve和reject的回调函数放入微任务队列。

5. then方法可以被调用多次

   5.1 promise状态变成 fulfilled 后，所有的 onFulfilled 回调都需要按照then的顺序执行, 也就是按照注册顺序执行(所以在实现的时候需要一个数组来存放多个onFulfilled的回调)
   5.2 promise状态变成 rejected 后，所有的 onRejected 回调都需要按照then的顺序执行, 也就是按照注册顺序执行(所以在实现的时候需要一个数组来存放多个onRejected的回调)

6. then的返回值 🌟🌟🌟

   then 应该返回一个新的promise，语法：

   promise2