读完这篇文章,预计会消耗你 40 分钟的时间。

Ajax 出现的时候,刮来了一阵异步之风,现在 Nodejs 火爆,又一阵异步狂风刮了过来。需求是越来越苛刻,用户对性能的要求也是越来越高,随之而来的是页面异步操作指数般增长,如果不能恰当的控制代码逻辑,我们就会陷入无穷的回调地狱中。

ECMAScript 6 已经将异步操作纳入了规范,现代浏览器也内置了 Promise 对象供我们进行异步编程,那么此刻,还在等啥?赶紧学习学习 Promise 的内部原理吧!

第一章 了解 Promise

一、场景再现

由于 javascript 的单线程性质,我们必须等待上一个事件执行完成才能处理下一步,如下:

// DOM ready之后执行
$(document).ready(function(){
// 获取模板
$.get(url, function(tpl){
// 获取数据
$.get(url2, function(data){
// 构建 DOMString
makeHtml(tpl, data, function(str){
// 插入到 DOM 中
$(obj).html(str);
});
});
});
});

为了减少首屏数据的加载,我们将一些模板和所有数据都放在服务器端,当用户操作某个按钮时,需要将模板和数据拼接起来插入到 DOM 中,这个过程还必须在 DOMReady 之后才能执行。这种情况是十分常见的,如果异步操作再多一些,整个代码的缩进让人看着很不舒服,为了优雅地处理这个问题,ECMAScript 6 引入了 Promise 的概念,目前一些现代浏览器已经支持这些新东西了!

二、模型

为了让代码流程更加清晰,我们假想着能够按照下面的流程来跑程序:

new Promise(ready).then(getTpl).then(getData).then(makeHtml).resolve();

先将要事务按照执行顺序依次 push 到事务队列中,push 完了之后再通过 resolve 函数启动整个流程。

整个流程的操作模型如下:

promise(ok).then(ok_1).then(ok_2).then(ok_3).reslove(value)------+
| | | | |
| | | | +=======+ |
| | | | | | |
| | | | | | |
+---------|----------|----------|--------→ ok() ←------+
| | | ||
| | | ||
+----------|----------|--------→ ok_1()|
| | ||
| | ||
+----------|--------→ ok_2()|
| ||
| ||
+--------→ ok_3()-----+
| | |
| |
@ Created By Barret Lee +=======+ exit

在 resolve 之前,promise 的每一个 then 都会将回调函数压入队列,resolve 后,将 resolve 的值送给队列的第一个函数,第一个函数执行完毕后,将执行结果再送入下一个函数,依次执行完队列。一连串下来,一气呵成,没有丝毫间断。

三、简单的封装

如果了解 Promise,可以移步下方,看看对 Promise 的封装:

Github: //github.com/barretlee/myPromiseDEMO: http://barretlee.github.io/myPromise/index.html

如果还不是很了解,可以往下阅读全文,了解一二。

第二章 Promise 原理

一、什么是 Promise ?

那么,什么是 Promise ?

Promise 可以简单理解为一个事务,这个事务存在三种状态:

  1. 已经完成了 resolved
  2. 因为某种原因被中断了 rejected
  3. 还在等待上一个事务结束 pending

上文中我们举了一个栗子,获取模板和数据之后再将拼合的数据插入到 DOM 中,这里我们将整个程序分解成多个事务:

事务一:     获取模板

事务二: 获取数据

事务三: 拼合之后插入到 DOM

在事务一结束之前,也就是模板代码从服务器拉取过来之前,事务二和事务三都处于 pending 状态,他们必须等待上一个事务结束。而事务一结束之后会将自身状态标记为 resolved,并把该事务中处理的结果移交给事务二继续处理(当然,这里如果没有数据返回,事务二就不会获得上一个事务的数据),依次类推,直到最后一个事务操作结束。

在事务操作的过程中,若遇到错误,比如事务一获取数据存在跨域问题,那事务就会操作失败,此时它会将自身的状态标记为 rejected,由于后续事务都是承接前一事务的,前一事务已经宣告工程已经玩不成了,那么后续的所有事务都会将自己标记为 rejected,其标记理由(reason)就是出错事务的报错信息(这个报错信息可以使用 try...catch 来捕获,也可以通过程序自身来捕获,如 ajax 的 onerror 事件、ajax 返回的状态码为 404 等)。

小结:Promise 就是一个事务的管理器。他的作用就是将各种内嵌回调的事务用流水形式表达,其目的是为了简化编程,让代码逻辑更加清晰。

由于整个程序的实现比较难理解,对于 Promise,我们将分为两部分阐述:

  • 无错误传递的 Promise,也就是事务不会因为任何原因中断,事务队列中的事项都会被依次处理,此过程中 Promise 只有 pending 和 resolved 两种状态,没有 rejected 状态。
  • 包含错误的 Promise,每个事务的处理都必须使用容错机制来获取结果,一旦出错,就会将错误信息传递给下一个事务,如果错误信息会影响下一个事务,则下一个事务也会 rejected,如果不会,下一个事务可以正常执行,依次类推。

二、无错误传递的 Promise(简化版的 Promise)

首先,我们需要用一个变量(status)来标记事务的状态,然后将事务(affair)也保存到 Promise 对象中。

var Promise = function(affair){
this.state = "pending";
this.affair = affair || function(o) { return o; };
this.allAffairs = [];
};

Promise 有两个重要的方法,一个是 then,另一个是 resolve:

  • then,将事务添加到事务队列(allAffairs)中
  • resolve,开启流程,让整个操作从第一个事务开始执行

在操作事务之前,我们会先把各种事务依次放入事务队列中,这里会用到 then 方法:

Promise.prototype.then = function (nextAffair){
var promise = new Promise();
if (this.state == "resloved"){
// 如果当前状态是已完成,则这个事务将会被立即执行
return this._fire(promise, nextAffair);
}else{
// 否则将会被加入队列中
return this._push(promise, nextAffair);
}
};

如果整个操作已经完成了,那 then 方法送进的事务会被立即执行,

Promise.prototype._fire = function (nextPromise, nextAffair){
var nextResult = nextAffair(this.result);
if (nextResult instanceof Promise){
nextResult.then(function(obj){
nextPromise.resolve(obj);
});
}else{
nextPromise.resolve(nextResult);
}
return nextPromise;
};

被立即执行之后会返回一个结果,这个结果会被传递到下一个事务中作为原料,但是这里需要考虑两种情况:
  1. 异步,如果这个结果也是一个 Promise,则需要等待这个 Promise 执行完毕再将最终的结果传到下一个事务中。
  2. 同步,如果这个结果不是 Promise,则直接将结果传递给下一个事务。

第一种情况还是比较常见的,比如我们在一个事务中有一个子事务队列需要处理,此时必须等待子事务完成才能回到主事务队列中。

Promise.prototype.resolve = function (obj){
if (this.state != "pending") {
throw "流程已完成,不能再次开启流程!";
}
this.state = "resloved";
// 执行该事务,并将执行结果寄存到 Promise 管理器上
this.result = this.affair(obj);
for (var i = 0, len = this.allAffairs.length; i < len; ++i){
// 往后执行事务
var affair = this.allAffairs[i];
this._fire(affair.promise, affair.affair);
}
return this;
};

resolve 接受一个参数,这个数据是交给第一个事务来处理的,因为第一个事务的启动可能需要点原料,这个数据就是原料,它也可以是空。该事物处理完毕之后,将操作结果(result)寄存在 Promise 对象上,方便引用,然后将结果(result)作为原料送入下一个事务。依次类推。

我们看到 then 方法中还调用了一个 _push ,这个方法的作用是将事务推进事务管理器(Promise)。

Promise.prototype._push = function (nextPromise, nextAffair){
this.allAffairs.push({
promise: nextPromise,
affair: nextAffair
});
return nextPromise;
};

以上操作,我们就实现了一个简单的事务管理器,可以测试下下面的代码:

// 初始化事务管理器
var promise = new Promise(function(data){
console.log(data);
return 1;
});
// 添加事务
promise.then(function(data){
console.log(data);
return 2;
}).then(function(data){
console.log(data);
return 3;
}).then(function(data){
console.log(data);
console.log("end");
});
// 启动事务
promise.resolve("start");

可以看到依次输出的结果为:

> start
> 1
> 2
> 3
> end

由于上述实现十分简陋,链式调用没做太好的处理,请读者自行完善:)

下面是一个异步操作演示:

var promise = new Promise(function(data){
console.log(data);
return "end";
});
promise.then(function(data){
// 这里需要返回一个 Promise,让主事务切换到子事务处理
return (function(data){
// 创建一个子事务
var promise = new Promise();
setTimeout(function(){
console.log(data);
// 一秒之后才启动子事务,模拟异步延时
promise.resolve();
}, 1000);
return promise;
})(data);
});
promise.resolve("start");

可以看到依次输出的结果为:
> start
> end (1s之后输出)

将函数写的稍微好看点:

function delay(data){
// 创建一个子事务
var promise = new Promise();
setTimeout(function(){
console.log(data);
// 一秒之后才启动子事务,模拟异步延时
promise.resolve();
}, 1000);
return promise;
}
// 主事务
var promise = new Promise(function(data){
console.log(data);
return "end";
});
promise.then(delay);
promise.resolve("start");

三、包含错误传递的 Promise

真的很羡慕你能看到这么详细的文章,当然,后面会更加精彩!

没有错误处理的 Promise 只能算是一个半成品,虽说可以通过在最外层加一个 try..catch 来捕获错误,但没法具体定位是哪个事务发生的错误。并且这里的错误不仅仅包含 JavaScript Error,还有诸如 ajax 返回的 data code 不是 200 的情况等。

先看一个浏览器内置 Promise 的实例(该代码可在现代浏览器下运行):

new Promise(function(resolve, reject){
resolve("start");
}).then(function(data){
console.log(data);
throw "error";
}).catch(function(err){
console.log(err);
return "end";
}).then(function(data){
console.log(data)
});

Promise 的回调和 then 方法都是接受两个参数:
new Promise(function(resolve, reject){
// ...
});

promise.then(
function(value){/* code here */},
function(reason){/* code here */}
);

事务处理过程中,如果有值返回,则作为 value,传入到 resolve 函数中,若有错误产生,则作为 reason 传入到 reject 函数中处理。

在初始化 Promise 对象时,若传入的回调中没有执行 resolve 或者 reject,这需要我们主动去启动事务队列。

promise.resolve();
promise.reject();

上面两种都是可以启动一个队列的。这里跟第二章第二节的 resolve 函数用法类似。Promise 对象还提供了 catch 函数,起用法等价于下面所示:

promise.catch();
// 等价于
promise.then(null, function(reason){});

还有两个 API:

promise.all();
promise.race();

后续再讲。先看看这个有错误处理的 Promise 是如何实现的。

function Promise(resolver){
this.status = "pending";
this.value = null;
this.handlers = [];
this._doPromise.call(this, resolver);
}

_doPromise 方法在实例化 Promise 函数时就执行。如果送入的回调函数 resolver 中已经 resolve 或者 reject 了,程序就已经启动了,所以在实例化的时候就开始判断。

_doPromise: function(resolver){
var called = false, self = this;
try{
resolver(function(value){
// 如果没有 call 则继续,并标记 called 为 true
!called && (called = !0, self.resolve(value));
}, function(reason){
// 同上
!called && (called = !0, self.reject(reason));
});
} catch(e) {
// 同上,捕获错误,传递错误到下一个 then 事务
!called && (called = !0, self.reject(e));
}
},

只要 resolve 或者 reject 就会标记程序 called 为 true,表示程序已经启动了。

resolve: function(value) {
try{
if(this === value){
throw new TypeError("流程已完成,不能再次开启流程!");
} else {
// 如果还有子事务队列,继续执行
value && value.then && this._doPromise(value.then);
}
// 执行完了之后标记为完成
this.status = "fulfilled";
this.value = value;
this._dequeue();
} catch(e) {
this.reject(e);
}
},
reject: function(reason) {
// 标记状态为出错
this.status = "rejected";
this.value = reason;
this._dequeue();
},

可以看到,每次 resolve 的时候都会用一个 try..catch 包裹来捕获未知错误。

_dequeue: function(){
var handler;
// 执行事务,直到队列为空
while (this.handlers.length) {
handler = this.handlers.shift();
this._handle(handler.thenPromise, handler.onFulfilled, handler.onRejected);
}
},

无论是 resolve 还是 reject 都会让程序往后奔流,直到结束所有事务,所以这两个方法中都有 _dequeue 函数。

_handle: function(thenPromise, onFulfilled, onRejected){
var self = this;

setTimeout(function() {
// 判断下次操作采用哪个函数,reject 还是 resolve
var callback = self.status == "fulfilled"
? onFulfilled
: onRejected;
// 只有是函数才会继续回调
if (typeof callback === "function") {
try {
self.resolve.call(thenPromise, callback(self.value));
} catch(e) {
self.reject.call(thenPromise, e);
}
return;
}
// 否则就将 value 传递给下一个事务了
self.status == "fulfilled"
? self.resolve.call(thenPromise, self.value)
: self.reject.call(thenPromise, self.value);
}, 1);
},

这个函数跟上一节提到的 _fire 类似,如果 callback 是 function,就会进入子事务队列,处理完了之后退回到主事务队列。最后一个 then 方法,将事务推进队列。

then: function(onFulfilled, onRejected){
var thenPromise = new Promise(function() {});

if (this.status == "pending") {
this.handlers.push({
thenPromise: thenPromise,
onFulfilled: onFulfilled,
onRejected: onRejected
});
} else {
this._handle(thenPromise, onFulfilled, onRejected);
}

return thenPromise;
}

如果第二节没有理解清楚,这一节也会让人头疼,这一部分讲的比较粗糙。

第三章 异步编程

一、jQuery 中的 Defferred 对象

或许你在面试的时候,有面试官问你:

$.ajax() 执行后返回的结果是什么?

在 jQuery1.5 版本就已经引入了 Defferred 对象,当时为了引入这个东西,整个 jQuery 都被重构了。Defferred 跟 Promise 类似,它表示一个还未完成任务的对象,而 Promise 确切的说,是一个代表未知值的对象。

$.ajax({
url: url
}).done(function(data, status, xhr){
//...
}).fail(function(){
//...
});

回忆下第二章第一节中的 Promise,是不是如出一辙,只是 jQuery 还提供了更多的语法糖:

$.ajax({
url: url,
success: function(data){
//...
},
error: funtion(){
//...
}
});

他允许将 done 和 fail 两个函数的回调放在 ajax 初始化的参数 success 和 fail 上,其原理还是一样的,同样,还有这样的东西:

$.when(taskOne, taskTwo).done(function () {
console.log("都执行完毕后才会输出我!");
}).fail(function(){
console.log("只要有一个失败,就会输出我!")
});

当 taskOne 和 taskTwo 都完成之后才执行 done 回调,这个浏览器内置的 Promise 也有对应的函数:

Promise.all([true, Promise.resolve(1), ...]).then(function(value){
//....
});

浏览器内置的 Promise 还提供了一个 API:

Promise.race([true, Promise.resolve(1), ...]).then(function(value){
//....
}, function(reason){
//...
});

只要 race 参数中有一个 resolve 或者 reject,then 回调就会出发。

二、基于事件响应的异步模型

@朴灵 写的 EventProxy 就是基于事件响应的异步模型,按理说,这个实现的逻辑是最清晰的,不过代码量稍微多一点。

function taskA(){
setTimeout(function(){
var result = "A";
E.emit("taskA", result);
}, 1000);
}

function taskB(){
setTimeout(function(){
var result = "B";
E.emit("taskB", result);
}, 1000);
}

E.all(["taskA", "taskB"], function(A, B){
return A + B;
});

我没有看他的源码,但是想想,应该是这个逻辑。只需要在消息中心管理各个 emit 以及消息注册。这里的错误处理值得思考下。

在半年前,也写过一篇关于异步编程的文章:JavaScript异步编程原理,感兴趣的可以去读一读。

第四章 小结

一、小结

文章比较长,阅读了好几天别人写的东西,自己提笔还是比较轻松的,本文大概花费了 6 个小时撰写。

本文主要解说了 Promise 的应用场景和实现原理,如果你能够顺畅的读完全文并且之处文中的一些错误,说明你已经悟到了:)

Promise 使用起来不难,但是理解其原理还是有点偏头痛的,所以下面列举的几篇相关阅读也建议读者点进去看看。

二、相关阅读