ES6 Promise 接口

构造函数

new Promise(function(resolve, reject){});

构造函数接受一个函数(executor)做为参数,该函数在返回 Promise 实例以前被调用。函数的两个参数分别是 resolve 和 reject 函数。es6

若是 executor 函数执行中抛出异常,则 Promise 视为 rejected。数组

executor 函数返回值没有意义。promise

类方法

Promise.all(iterable)

相似于 jQuery.when() 方法,只有 iterable 中全部的 Promise 都被 resolve,它返回一个新的被 resolve 的 Promise,resolved 值为 iterable 中全部 resolved 值组成的数组;或者 iterable 中只要有一个 Promise 被 reject,则马上返回一个新的被 reject 的 Promise,rejected 值同时传递给新的 Promise。浏览器

Promise.race(iterable)

一旦 iterable 中任何一个 Promise 被 resolve 或 reject,则当即返回一个新的被 resolve 或 reject 的 Promise。异步

Promise.reject(reason)

返回一个 rejected Promise。async

Promise.resolve(value)

返回一个新的 Promise。若是 value 是一个 thenable 对象(Promise),新 Promise 状态与 thenable 一致;不然新 Promise 状态为 resolved,Promise 结果为 value。函数

实例方法

Promise.prototype.catch(onRejected)

返回一个新的 Promise。Promise 将 rejected 值视为一个 error,经过 catch 方法能够捕捉 rejected 值,并将该值传递给 onRejected 函数。onRejected 函数返回值将做为新 Promise 的 resolve 参数,也就是说,若是 onRejected 返回值是一个 Promise,则新 Promise 与该 Promise 状态一致;不然新 Promise 状态为 resolved,结果值为 onRejected 返回值。this

若是一个 rejected Promise 没有调用过 catch 方法,在谷歌浏览器控制台会输出异常提示 Uncaught (in promise) 1prototype

Promise.prototype.then(onFulfilled, onRejected)

返回一个新 Promise。若是 onFulfilled 和 onRejected 是函数,则使用它们的返回值做为新 Promise 的 resolve 参数。不然新 Promise 与旧 Promise 状态保持一致。code

then 与 catch

虽然 then 方法能够分别处理 resolution 和 rejection 两种情景,但 ES6 Promise 将 rejection 更多地视做异步异常情景,所以提供 catch 方法处理 rejection 情景。

因此好的实践是使用 then 方法处理 resolution,catch 方法处理 rejection。

// 不推荐
asyncRun().then(function(value) {}, function(error) {});

// 推荐
asyncRun().then(function(value){}).catch(function(rejected) {});

尤为当须要连接多个 Promise 时,使用 then + catch 模式会让代码更加清晰。

// 不推荐
asyncRun()
    .then(function(value) {}, function(error) {})
    .then(function(value) {}, function(error) {})
    .then(function(value) {}, function(error) {});

// 推荐
asyncRun()
    .then(function(value){})        
    .then(function(value){})
    .then(function(value){})
    .catch(function(rejected) {});

Deferred 对象

ES6 取消了 Deferred 对象,鼓励直接使用 Promise,并且主张 Promise 应该由它的建立者来 resolve 或 reject。

但某些场景下,Deferred 对象仍然是一种更好的选择,尤为是 Promise 建立者与求值者分属不一样对象时。

基于 ES6 Promise 实现的 Deferred 对象

简洁版:

function Deferred() {
    var self = this;
    var promise = this.promise = new Promise(function(resolve, reject) {
        self.resolve = resolve;
        self.reject = reject;
    });
    this.then = this.promise.then.bind(promise);
    this.catch = this.promise.catch.bind(promise);
    this.catch(function() {});
}

完整版:

/*
 * @Author: laixi
 * @Date:   2016-11-18 11:40:06
 * @Last Modified by:   laixi
 * @Last Modified time: 2016-11-18 12:36:26
 */
var Deferred = function(beforeStart) {
  if (!(this instanceof Deferred)) {
    return new Deferred(beforeStart);
  }

  var _resolve;   // resolve function
  var _reject;  // reject function
  var _result;  // resolved value or rejected reason
  var _state = 'pending';   // promise status
  var doneCallbacks = [];
  var failCallbacks = [];
  var alwaysCallbacks = [];

  // create promise object
  var promise = new Promise(function(resolve, reject) {
    _resolve = resolve;
    _reject = reject;
  });

  // eliminate annoying error prompt at Chrome console
  promise.catch(function() {});
  
  // respectively call callbacks in done callback queue or fail callback queue
  promise.then(function(value) {
    _result = value;
    while (doneCallbacks.length > 0) {
      var callback = doneCallbacks.splice(0, 1)[0];
      callback.call(promise, value);
    }
  }, function(reason) {
    _result = reason;
    while (failCallbacks.length > 0) {
      var callback = failCallbacks.splice(0, 1)[0];
      callback.call(promise, reason);
    }
  });

  // extend promise by adding done, fail, always.
  // ----------------------------------------------

  promise.done = function(callback) {
    if (typeof callback === 'function') {
      if (_state === 'resolved') {
        callback.call(promise, _result);
      } else {
        doneCallbacks.push(callback);
      }
    }
    return promise;
  };

  promise.fail = function(callback) {
    if (typeof callback === 'function') {
      if (_state === 'rejected') {
        callback.call(promise, _result);
      } else {
        failCallbacks.push(callback);
      }
    }
    return promise;
  };

  promise.always = function(callback) {
    if (typeof callback === 'function') {
      if (_state === 'pending') {
        alwaysCallbacks.push(callback);
      } else {
        callback.call(promise, _result);
      }
    }
    return promise;
  };

  this.promise = function() {
    return promise;
  };

  this.state = function() {
    return _state;
  };

  this.resolve = function(value) {
    _state = 'resolved';
    _resolve.call(promise, value);
  };

  this.reject = function(reason) {
    _state = 'rejected';
    _reject.call(promise, reason);
  };

  this.catch = promise.catch.bind(promise);
  this.then = promise.then.bind(promise);
  this.done = promise.done.bind(promise);
  this.fail = promise.fail.bind(promise);
  this.always = promise.always.bind(promise);

  if (typeof beforeStart === 'function') {
    beforeStart.call(this, this);
  }
};
相关文章
相关标签/搜索