Promise/A+规范

刺骨的言语ヽ痛彻心扉 2022-02-02 16:15 88阅读 0赞

Promise表示一个异步操作的最终结果。与Promise最主要的交互方法是通过将函数传入它的then方法从而获取得Promise最终的值或Promise最终最拒绝（reject）的原因。

## 1. 术语 ##

`promise`是一个包含了兼容promise规范then方法的对象或函数，  
`thenable` 是一个包含了then方法的对象或函数。  
`value` 是任何Javascript值。 (包括 undefined, thenable, promise等).  
`exception` 是由`throw`表达式抛出来的值。  
`reason` 是一个用于描述Promise被拒绝原因的值。

## 2. 要求 ##

### 2.1 Promise状态 ###

一个Promise必须处在其中之一的状态：pending, fulfilled 或 rejected.

*  如果是pending状态,则promise：  
     
    
     *  可以转换到fulfilled或rejected状态。
 *  如果是fulfilled状态,则promise：  
     
    
     *  不能转换成任何其它状态。
     *  必须有一个值，且这个值不能被改变。
 *  如果是rejected状态,则promise可以：  
     
    
     *  不能转换成任何其它状态。
     *  必须有一个原因，且这个值不能被改变。

”值不能被改变”指的是其identity不能被改变，而不是指其成员内容不能被改变。

### 2.2 `then` 方法 ###

一个Promise必须提供一个then方法来获取其值或原因。  
Promise的then方法接受两个参数：

promise.then(onFulfilled, onRejected)

1.  `onFulfilled` 和 `onRejected` 都是可选参数：  
     
    
    1.  如果`onFulfilled`不是一个函数，则忽略之。
    2.  如果`onRejected`不是一个函数，则忽略之。
2.  如果`onFulfilled`是一个函数:  
     
    
    1.  它必须在`promise` fulfilled后调用， 且`promise`的value为其第一个参数。
    2.  它不能在`promise` fulfilled前调用。
    3.  不能被多次调用。
3.  如果`onRejected`是一个函数,  
     
    
    1.  它必须在`promise` rejected后调用， 且`promise`的reason为其第一个参数。
    2.  它不能在`promise` rejected前调用。
    3.  不能被多次调用。
4.  `onFulfilled` 和 `onRejected` 只允许在 [execution context][] 栈仅包含平台代码时运行. \[3.1\].
5.  `onFulfilled` 和 `onRejected` 必须被当做函数调用 (i.e. 即函数体内的 `this` 为`undefined`). \[3.2\]
6.  对于一个`promise`，它的then方法可以调用多次.  
     
    
    1.  当`promise` fulfilled后，所有`onFulfilled`都必须按照其注册顺序执行。
    2.  当`promise` rejected后，所有`OnRejected`都必须按照其注册顺序执行。
7.  `then` 必须返回一个promise \[3.3\].
    
        promise2 = promise1.then(onFulfilled, onRejected);
    
    1.  如果`onFulfilled` 或 `onRejected` 返回了值`x`, 则执行Promise 解析流程`[[Resolve]](promise2, x)`.
    2.  如果`onFulfilled` 或 `onRejected`抛出了异常`e`, 则`promise2`应当以`e`为`reason`被拒绝。
    3.  如果 `onFulfilled` 不是一个函数且`promise1`已经fulfilled，则`promise2`必须以`promise1`的值fulfilled.
    4.  如果 `OnReject` 不是一个函数且`promise1`已经rejected, 则`promise2`必须以相同的reason被拒绝.

### 2.3 Promise解析过程 ###

**Promise解析过程** 是以一个promise和一个值做为参数的抽象过程，可表示为`[[Resolve]](promise, x)`. 过程如下；

1.  如果`promise` 和 `x` 指向相同的值, 使用 `TypeError`做为原因将`promise`拒绝。
2.  如果 `x` 是一个`promise`, 采用其状态 \[3.4\]:  
     
    
    1.  如果`x`是pending状态，`promise`必须保持pending走到`x` fulfilled或rejected.
    2.  如果`x`是fulfilled状态，将`x`的值用于fulfill `promise`.
    3.  如果`x`是rejected状态, 将`x`的原因用于reject `promise`..
3.  如果`x`是一个对象或一个函数：  
     
    
    1.  将 `then` 赋为 `x.then`. \[3.5\]
    2.  如果在取`x.then`值时抛出了异常，则以这个异常做为原因将`promise`拒绝。
    3.  如果 `then` 是一个函数， 以`x`为`this`调用`then`函数， 且第一个参数是`resolvePromise`，第二个参数是`rejectPromise`，且：  
         
        
        1.  当 `resolvePromise` 被以 `y`为参数调用, 执行 `[[Resolve]](promise, y)`.
        2.  当 `rejectPromise` 被以 `r` 为参数调用, 则以`r`为原因将`promise`拒绝。
        3.  如果 `resolvePromise` 和 `rejectPromise` 都被调用了，或者被调用了多次，则只第一次有效，后面的忽略。
        4.  如果在调用`then`时抛出了异常，则：  
             
            
            1.  如果 `resolvePromise` 或 `rejectPromise` 已经被调用了，则忽略它。
            2.  否则, 以`e`为reason将 `promise` 拒绝。
    4.  如果 `then`不是一个函数，则 以`x`为值fulfill `promise`。
4.  如果 `x` 不是对象也不是函数，则以`x`为值 fulfill `promise`。

/**
     * Created by wangyang on 2019-05-06.
     * itwangyang@gmail.com
     * http://www.itwangyang.xyz
     */
    
    /**
     * promise 是一个类，可以创建实例
     * 代码承诺，什么时候回用到承诺，一般是异步任务，就是需要很长时间执行的
     *
     *
     */
    let Promise = require('./06.ES6-promise.js');
    let p1 = new Promise(function(resolve, reject) {
      setTimeout(function() {
        let num = Math.random();//生成一个随机数
        if(num>.5){
          //如果这个promise成功了，会调用成功的回调 fulfilled
          resolve('大');
        }else{
          //如果这个promise失败了，会调用失败的回调 rejected
          reject('小');
        }
      }, 2000);
    });
    
    p1.then(function (value) {
      console.log('成功'+value);
    },function (reason) {
      console.log('失败'+reason);
    });

[execution context]: https://es5.github.io/#x10.3