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;

    })

巴特西