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;
    })