ECMAScript 6 Promise 对象

一、Promise的含义

• 所谓Promise，简单说就是一个容器，里面保存着某个未来才会结束的事件（通常是一个异步操作）的结果。从语法上说，Promise是一个对象，从它可以获取异步操作的消息。

1、Promise对象两大特点

1.对象的状态不受外界影响

• Promise对象代表一个异步操作，有三种状态：Pending（进行中）、Resolved（已完成，又称Fulfilled）和Rejected（已失败）。
• 只有异步操作的结果，可以决定当前是哪一种状态，任何其他操作都无法改变这个状态。

2.一旦状态改变，就不会再变，任何时候都可以得到这个结果。

• Promise对象的状态改变，只有两种可能：从Pending变为Resolved和从Pending变为Rejected。

二、基本用法

1、ES6规定，Promise对象是一个构造函数，用来生成Promise实例

var promise = new Promise(function(resolve, reject) {
  // ... some code

  if (/* 异步操作成功 */){
    resolve(value);
  } else {
    reject(error);
  }
});

• Promise构造函数接受一个函数作为参数，该函数的两个参数分别是resolve和reject。它们是两个函数，由JavaScript引擎提供，不用自己部署。

• resolve函数的作用是，将Promise对象的状态从‘未完成’变成‘成功’（即Pending变成Resolved），在异步操作成功时调用，并将异步操作的结果，作为参数传递出去

• reject函数的作用是，将Promise对象的状态从‘未完成’变为‘失败’（即从Pending变成Rejected），在异步操作失败时调用，并将异步操作报出的错误，作为参数传递出去

• Promise实例生成后，可以用then方法分别制定Resolved状态和Reject状态的回调函数

    promise.then(function(value) {
      // success
    }, function(error) {
      // failure
    });
  

• then方法可以接受两个回调函数作为参数。第一个回调函数是Promise对象的状态变为Resolved时调用，第二个回调函数是Promise对象的状态变为Reject时调用。其中，第二个函数是可选的，不一定要提供。这两个函数都接受Promise对象传出的值作为参数。

    function timeout(ms) {
      return new Promise((resolve, reject) => {
        setTimeout(resolve, ms, 'done');
      });
    }
    
    timeout(100).then((value) => {
      console.log(value);
    });
  

三、Promise.prototype.then()

• Promise实例具有then方法，也就是说，then方法是定义在原型对象Promise.prototype上的。它的作用是为Promise实例添加状态改变时的回调函数。

四、Promise.prototype.catch()

• Promise.prototype.catch方法是.then(null, rejection)的别名，用于指定发生错误时的回调函数。

五、Promise.all()

• Promise.all方法用于将多个Promise实例，包装成一个新的Promise实例。

    var p = Promise.all([p1, p2, p3]);
  

六、Promise.race()

• Promise.race方法同样是将多个Promise实例，包装成一个新的Promise实例。

    var p = Promise.race([p1,p2,p3]);
  

七、Promise.resolve()

• 有时需要将现有对象转为Promise对象，Promise.resolve方法就起到这个作用。

    var jsPromise = Promise.resolve($.ajax('/whatever.json'));
  

• Promise.resolve等价于下面的写法。

    Promise.resolve('foo')
    // 等价于
    new Promise(resolve => resolve('foo'))
  

Promise.resolve方法的参数分成四种情况。

（1）参数是一个Promise实例

• 如果参数是Promise实例，那么Promise.resolve将不做任何修改、原封不动地返回这个实例。

（2）参数是一个thenable对象

• thenable对象指的是具有then方法的对象，比如下面这个对象。

    let thenable = {
      then: function(resolve, reject) {
        resolve(42);
      }
    };
  

• Promise.resolve方法会将这个对象转为Promise对象，然后就立即执行thenable对象的then方法。

    let thenable = {
      then: function(resolve, reject) {
        resolve(42);
      }
    };
    
    let p1 = Promise.resolve(thenable);
    p1.then(function(value) {
      console.log(value);  // 42
    });
  

• 上面代码中，thenable对象的then方法执行后，对象p1的状态就变为resolved，从而立即执行最后那个then方法指定的回调函数，输出42。

（3）参数不是具有then方法的对象，或根本就不是对象

• 如果参数是一个原始值，或者是一个不具有then方法的对象，则Promise.resolve方法返回一个新的Promise对象，状态为Resolved。

    var p = Promise.resolve('Hello');
    
    p.then(function (s){
      console.log(s)
    });
    // Hello
  

• 上面代码生成一个新的Promise对象的实例p。由于字符串Hello不属于异步操作（判断方法是它不是具有then方法的对象），返回Promise实例的状态从一生成就是Resolved，所以回调函数会立即执行。Promise.resolve方法的参数，会同时传给回调函数。

（4）不带有任何参数

• Promise.resolve方法允许调用时不带参数，直接返回一个Resolved状态的Promise对象。

八、Promise.reject()

• Promise.reject(reason)方法也会返回一个新的Promise实例，该实例的状态为rejected。它的参数用法与Promise.resolve方法完全一致。

    var p = Promise.reject('出错了');
    // 等同于
    var p = new Promise((resolve, reject) => reject('出错了'))
    
    p.then(null, function (s){
      console.log(s)
    });
    // 出错了
  

九、两个有用的附加方法

1.done()

• Promise对象的回调链，不管以then方法或catch方法结尾，要是最后一个方法抛出错误，都有可能无法捕捉到（因为Promise内部的错误不会冒泡到全局）。因此，我们可以提供一个done方法，总是处于回调链的尾端，保证抛出任何可能出现的错误。

    asyncFunc()
      .then(f1)
      .catch(r1)
      .then(f2)
      .done();
  

• 它的实现代码相当简单。

    Promise.prototype.done = function (onFulfilled, onRejected) {
      this.then(onFulfilled, onRejected)
        .catch(function (reason) {
          // 抛出一个全局错误
          setTimeout(() => { throw reason }, 0);
        });
    };
  

2.finally()

• finally方法用于指定不管Promise对象最后状态如何，都会执行的操作。它与done方法的最大区别，它接受一个普通的回调函数作为参数，该函数不管怎样都必须执行。

• 服务器使用Promise处理请求，然后使用finally方法关掉服务器。

    server.listen(0)
      .then(function () {
        // run test
      })
      .finally(server.stop);
  

• 它的实现也很简单。

    Promise.prototype.finally = function (callback) {
      let P = this.constructor;
      return this.then(
        value  => P.resolve(callback()).then(() => value),
        reason => P.resolve(callback()).then(() => { throw reason })
      );
    };
  

十、应用

1、加载图片

• 我们可以将图片的加载写成一个Promise，一旦加载完成，Promise的状态就发生变化。

    const preloadImage = function (path) {
      return new Promise(function (resolve, reject) {
        var image = new Image();
        image.onload  = resolve;
        image.onerror = reject;
        image.src = path;
      });
    };
  

2、Generator函数与Promise的结合

• 使用Generator函数管理流程，遇到异步操作的时候，通常返回一个Promise对象。

    function getFoo () {
      return new Promise(function (resolve, reject){
        resolve('foo');
      });
    }
  
    var g = function* () {
      try {
        var foo = yield getFoo();
        console.log(foo);
      } catch (e) {
        console.log(e);
      }
    };
  
    function run (generator) {
      var it = generator();
  
      function go(result) {
        if (result.done) return result.value;
  
        return result.value.then(function (value) {
          return go(it.next(value));
        }, function (error) {
          return go(it.throw(error));
        });
      }
  
      go(it.next());
    }
  
    run(g);
  

• 面代码的Generator函数g之中，有一个异步操作getFoo，它返回的就是一个Promise对象。函数run用来处理这个Promise对象，并调用下一个next方法。

简单例子

    let state = 1;
    function step1(resolve,reject){
        console.log('1-开始洗菜做饭');
        if( state == 1){
            resolve('洗菜做饭完成');
        }else {
            reject('洗菜做饭出错');
        }
    }

    function step2(resolve,reject){
        console.log('2-开始-坐下来吃饭');
        if (state == 1) {
            resolve('坐下来吃饭完成');
        }else {
            reject('坐下来吃饭出错');
        }
    }

    function step3(resolve,reject) {
        console.log('3-开始收拾桌子洗碗');
        if(state==1){
            resolve('收拾桌子洗碗完成');
        }else{
            reject('收拾桌子洗碗出错')
        }
    }

    new Promise(step1).then(function(val){
        console.log(val);
        return new Promise(step2);
    }).then(function(val){
        console.log(val);
        return new Promise(step3);
    }).then(function(val){
        console.log(val);
        return val;
    })