每个版本都会引入一些新功能。今天我想介绍的，就是从jQuery 1.5.0版本开始引入的一个新功能---- deferred对象 。

这个功能很重要，未来将成为jQuery的核心方法，它彻底改变了如何在jQuery中使用ajax。为了实现它，jQuery的全部ajax代码都被改写了。但是，它比较抽象，初学者很难掌握，网上的教程也不多。所以，我把自己的学习笔记整理出来了，希望对大家有用。

本文不是初级教程，针对的读者是那些已经具备jQuery使用经验的开发者。如果你想了解jQuery的基本用法，请阅读我编写的 《jQuery设计思想》 和 《jQuery最佳实践》 。

======================================

jQuery的deferred对象详解

作者：阮一峰

一、什么是deferred对象？

开发网站的过程中，我们经常遇到某些耗时很长的javascript操作。其中，既有异步的操作（比如ajax读取服务器数据），也有同步的操作（比如遍历一个大型数组），它们都不是立即能得到结果的。

通常的做法是，为它们指定回调函数（callback）。即事先规定，一旦它们运行结束，应该调用哪些函数。

但是，在回调函数方面，jQuery的功能非常弱。为了改变这一点，jQuery开发团队就设计了 deferred对象 。

简单说，deferred对象就是jQuery的回调函数解决方案。 在英语中，defer的意思是"延迟"，所以deferred对象的含义就是"延迟"到未来某个点再执行。

它解决了如何处理耗时操作的问题，对那些操作提供了更好的控制，以及统一的编程接口。它的主要功能，可以归结为四点。下面我们通过示例代码，一步步来学习。

二、ajax操作的链式写法

首先，回顾一下jQuery的ajax操作的传统写法：

$.ajax({

url: "test.html",

success: function(){
alert("哈哈，成功了！");

error:function(){
alert("出错啦！");

（运行 代码示例1 ）

在上面的代码中，$.ajax()接受一个对象参数，这个对象包含两个方法：success方法指定操作成功后的回调函数，error方法指定操作失败后的回调函数。

$.ajax()操作完成后，如果使用的是低于1.5.0版本的jQuery，返回的是XHR对象，你没法进行链式操作；如果高于1.5.0版本，返回的是deferred对象，可以进行链式操作。

现在，新的写法是这样的：

$.ajax("test.html")

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例2 ）

可以看到， done() 相当于success方法， fail() 相当于error方法。采用链式写法以后，代码的可读性大大提高。

三、指定同一操作的多个回调函数

deferred对象的一大好处，就是它允许你自由添加多个回调函数。

还是以上面的代码为例，如果ajax操作成功后，除了原来的回调函数，我还想再运行一个回调函数，怎么办？

很简单，直接把它加在后面就行了。

$.ajax("test.html")

.done(function(){ alert("哈哈，成功了！");} )

.fail(function(){ alert("出错啦！"); } )

.done(function(){ alert("第二个回调函数！");} );

（运行 代码示例3 ）

回调函数可以添加任意多个，它们按照添加顺序执行。

四、为多个操作指定回调函数

deferred对象的另一大好处，就是它允许你为多个事件指定一个回调函数，这是传统写法做不到的。

请看下面的代码，它用到了一个新的方法 $.when() ：

$.when($.ajax("test1.html"), $.ajax("test2.html"))

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例4 ）

这段代码的意思是，先执行两个操作$.ajax("test1.html")和$.ajax("test2.html")，如果都成功了，就运行done()指定的回调函数；如果有一个失败或都失败了，就执行fail()指定的回调函数。

五、普通操作的回调函数接口（上）

deferred对象的最大优点，就是它把这一套回调函数接口，从ajax操作扩展到了所有操作。也就是说，任何一个操作----不管是ajax操作还是本地操作，也不管是异步操作还是同步操作----都可以使用deferred对象的各种方法，指定回调函数。

我们来看一个具体的例子。假定有一个很耗时的操作wait：

var wait = function(){

var tasks = function(){

alert("执行完毕！");

setTimeout(tasks,5000);

我们为它指定回调函数，应该怎么做呢？

很自然的，你会想到，可以使用$.when()：

$.when(wait())

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例5 ）

但是，这样写的话，done()方法会立即执行，起不到回调函数的作用。原因在于$.when()的参数只能是deferred对象，所以必须对wait()进行改写：

var dtd = $.Deferred(); // 新建一个deferred对象

var wait = function(dtd){

var tasks = function(){

alert("执行完毕！");

dtd.resolve(); // 改变deferred对象的执行状态

setTimeout(tasks,5000);

return dtd;

现在，wait()函数返回的是deferred对象，这就可以加上链式操作了。

$.when(wait(dtd))

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例6 ）

wait()函数运行完，就会自动运行done()方法指定的回调函数。

六、deferred.resolve()方法和deferred.reject()方法

如果仔细看，你会发现在上面的wait()函数中，还有一个地方我没讲解。那就是 dtd.resolve() 的作用是什么？

要说清楚这个问题，就要引入一个新概念"执行状态"。jQuery规定，deferred对象有三种执行状态----未完成，已完成和已失败。如果执行状态是"已完成"（resolved）,deferred对象立刻调用done()方法指定的回调函数；如果执行状态是"已失败"，调用fail()方法指定的回调函数；如果执行状态是"未完成"，则继续等待，或者调用 progress() 方法指定的回调函数（jQuery1.7版本添加）。

前面部分的ajax操作时，deferred对象会根据返回结果，自动改变自身的执行状态；但是，在wait()函数中，这个执行状态必须由程序员手动指定。dtd.resolve()的意思是，将dtd对象的执行状态从"未完成"改为"已完成"，从而触发done()方法。

类似的，还存在一个 deferred.reject() 方法，作用是将dtd对象的执行状态从"未完成"改为"已失败"，从而触发fail()方法。

var dtd = $.Deferred(); // 新建一个Deferred对象

var wait = function(dtd){

var tasks = function(){

alert("执行完毕！");

dtd.reject(); // 改变Deferred对象的执行状态

setTimeout(tasks,5000);

return dtd;

$.when(wait(dtd))

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例7 ）

七、deferred.promise()方法

上面这种写法，还是有问题。那就是dtd是一个全局对象，所以它的执行状态可以从外部改变。

请看下面的代码：

var dtd = $.Deferred(); // 新建一个Deferred对象

var wait = function(dtd){

var tasks = function(){

alert("执行完毕！");

dtd.resolve(); // 改变Deferred对象的执行状态

setTimeout(tasks,5000);

return dtd;

$.when(wait(dtd))

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

dtd.resolve();

（运行 代码示例8 ）

我在代码的尾部加了一行dtd.resolve()，这就改变了dtd对象的执行状态，因此导致done()方法立刻执行，跳出"哈哈，成功了！"的提示框，等5秒之后再跳出"执行完毕！"的提示框。

为了避免这种情况，jQuery提供了 deferred.promise() 方法。它的作用是，在原来的deferred对象上返回另一个deferred对象，后者只开放与改变执行状态无关的方法（比如done()方法和fail()方法），屏蔽与改变执行状态有关的方法（比如resolve()方法和reject()方法），从而使得执行状态不能被改变。

请看下面的代码：

var dtd = $.Deferred(); // 新建一个Deferred对象

var wait = function(dtd){

var tasks = function(){

alert("执行完毕！");

dtd.resolve(); // 改变Deferred对象的执行状态

setTimeout(tasks,5000);

return dtd.promise(); // 返回promise对象

var d = wait(dtd); // 新建一个d对象，改为对这个对象进行操作

$.when(d)

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

d.resolve(); // 此时，这个语句是无效的

（运行 代码示例9 ）

在上面的这段代码中，wait()函数返回的是promise对象。然后，我们把回调函数绑定在这个对象上面，而不是原来的deferred对象上面。这样的好处是，无法改变这个对象的执行状态，要想改变执行状态，只能操作原来的deferred对象。

不过，更好的写法是 allenm 所指出的，将dtd对象变成wait(）函数的内部对象。

var wait = function(dtd){

var dtd = $.Deferred(); //在函数内部，新建一个Deferred对象

var tasks = function(){

alert("执行完毕！");

dtd.resolve(); // 改变Deferred对象的执行状态

setTimeout(tasks,5000);

return dtd.promise(); // 返回promise对象

$.when(wait())

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例10 ）

八、普通操作的回调函数接口（中）

另一种防止执行状态被外部改变的方法，是使用deferred对象的建构函数$.Deferred()。

这时，wait函数还是保持不变，我们直接把它传入$.Deferred()：

$.Deferred(wait)

.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

（运行 代码示例11 ）

jQuery规定，$.Deferred()可以接受一个函数名（注意，是函数名）作为参数，$.Deferred()所生成的deferred对象将作为这个函数的默认参数。

九、普通操作的回调函数接口（下）

除了上面两种方法以外，我们还可以直接在wait对象上部署deferred接口。

var dtd = $.Deferred(); // 生成Deferred对象

var wait = function(dtd){

var tasks = function(){

alert("执行完毕！");

dtd.resolve(); // 改变Deferred对象的执行状态

setTimeout(tasks,5000);

dtd.promise(wait);

wait.done(function(){ alert("哈哈，成功了！"); })

.fail(function(){ alert("出错啦！"); });

wait(dtd);

（运行 代码示例12 ）

这里的关键是dtd.promise(wait)这一行，它的作用就是在wait对象上部署Deferred接口。正是因为有了这一行，后面才能直接在wait上面调用done()和fail()。

十、小结：deferred对象的方法

前面已经讲到了deferred对象的多种方法，下面做一个总结：

（1） $.Deferred() 生成一个deferred对象。

（2） deferred.done() 指定操作成功时的回调函数

（3） deferred.fail() 指定操作失败时的回调函数

（4） deferred.promise() 没有参数时，返回一个新的deferred对象，该对象的运行状态无法被改变；接受参数时，作用为在参数对象上部署deferred接口。

（5） deferred.resolve() 手动改变deferred对象的运行状态为"已完成"，从而立即触发done()方法。

（6） deferred.reject() 这个方法与deferred.resolve()正好相反，调用后将deferred对象的运行状态变为"已失败"，从而立即触发fail()方法。

（7） $.when() 为多个操作指定回调函数。

除了这些方法以外，deferred对象还有二个重要方法，上面的教程中没有涉及到。

（8） deferred.then()

有时为了省事，可以把done()和fail()合在一起写，这就是then()方法。

$.when($.ajax( "/main.php" ))

.then(successFunc, failureFunc );

如果then()有两个参数，那么第一个参数是done()方法的回调函数，第二个参数是fail()方法的回调方法。如果then()只有一个参数，那么等同于done()。

（9） deferred.always()

这个方法也是用来指定回调函数的，它的作用是，不管调用的是deferred.resolve()还是deferred.reject()，最后总是执行。

$.ajax( "test.html" )

.always( function() { alert("已执行！");} );

（致谢：本文第一稿发表后， allenm 来信指出原文对promise()的理解是错的。现在的第二稿是根据 他的文章 修改的，在此我表示衷心感谢。）

博主您好,
我看了这篇文章有几点感悟不知道是不是对的.1、用deferred可以简化$.ajax,但是deferred也没有丰满$.ajax的功能.因为$.ajax同样有seccess,error的方法,而且方法里面 你还能调用其他方法.success:myfunction 这样也能复用.而且$.ajax也有异步或同步的属性.2、deferred的出现解决了一个非ajax请求的监听事件是否执行成功的一系列方法。
不知道我的看法是不是对的。还请博主指教。

其实我们可以看到，var d = $.Deferred()，与 var p = d.promise(); 这两者的区别主要就在于， d 包含了 resolve, resolveWith, reject 与 rejectWith 这四个方法。而这四个方法就是用来触发 done, fail, always 这些个回调函数的。
之所以要返回 d.promise()： 一是因为 CommonJS promise/A 本来就应当是这样子的；二也是用来避免返回的对象能够主动地调用到resolve与reject这些关键性的方法。

引用白洁的发言：

博主您好,我看了这篇文章有几点感悟不知道是不是对的.1、用deferred可以简化$.ajax,但是deferred也没有丰满$.ajax的功能.因为$.ajax同样有seccess,error的方法,而且方法里面 你还能调用其他方法.success:myfunction 这样也能复用.而且$.ajax也有异步或同步的属性.2、deferred的出现解决了一个非ajax请求的监听事件是否执行成功的一系列方法。不知道我的看法是不是对的。还请博主指教。

不影响原来ajax的使用，异步或同步的属性，还有传递的参数的使用方式还是和原来的一样。

我觉得Deferred这个功能，并不能真正解决对本地非异步方法的封装，因为javascript是单线程的，如果该方法需要很长时间执行，例如下面这样一个函数

var array = new Array();
var i = 1;
while (i array.push(i);
array = array.reverse();
那么，在执行这个函数的时候，整个页面还是被卡住的。即便可以通过本文所说的技术用Deffered。

有没有什么方法将这种长时间的方法，真正实现出来异步的效果，做完之后再调用回调函数即可。

请阮兄指教

呵呵，文章写的很清晰，从使用上都理解了，关于具体实现的细节我没有看jquery的源码，下面是我自己整理的一个简单关于Defered和when的实现，没有添加参数传递的部分，希望能给大家一点帮助：

地址 http://jsfiddle.net/springwang/uW6tb/9/

// Success/Error if ( isSuccess ) { deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); } else { deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );

// Complete
completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );

如果有三个事件event01,event02,event03,要event01->event02->event03顺序执行。要怎么写？
我试了$.when(event01()).done(event02).done(event03);但是不行，event02和event03同时执行了。

http://jsfiddle.net/McGradi/PUb3Z/

博主您好,
我看了这篇文章有几点感悟不知道是不是对的.1、用deferred可以简化$.ajax,但是deferred也没有丰满$.ajax的功能.因为$.ajax同样有seccess,error的方法,而且方法里面 你还能调用其他方法.success:myfunction 这样也能复用.而且$.ajax也有异步或同步的属性.2、deferred的出现解决了一个非ajax请求的监听事件是否执行成功的一系列方法。
不知道我的看法是不是对的。还请博主指教。

var dtd = $.Deferred(); // 新建一个deferred对象
var wait = function(dtd){
var tasks = function(){
alert("执行完毕！");
dtd.resolve(); // 改变deferred对象的执行状态
setTimeout(tasks,5000);
return dtd;

可以写成下面这样吧？

var dtd = $.Deferred(); // 新建一个deferred对象
var wait = function(){
var tasks = function(){
alert("执行完毕！");
dtd.resolve(); // 改变deferred对象的执行状态
setTimeout(tasks,5000);

var wait = function(dtd){
var dtd = $.Deferred(); //在函数内部，新建一个Deferred对象
var tasks = function(){
alert("执行完毕！");
dtd.resolve(new Date()); // 执行完成后，返回当前时间

setTimeout(tasks,5000);
return dtd.promise(); // 返回promise对象
$.when(wait())
.done(function(time){ alert("完成时间：" + time); })
.fail(function(){ alert("出错啦！"); });

Promise当reject时, 没有任务程序去处理, 不是就会被忽略了, 不能像throw那样, 最后报错.
这个问题是, 我在使用Promise时, 发现如果我没有调用catch(), 也不报错, 经常因为没有catch(), 没发现错误.
有什么办法可解决, 当没有catch时, 就抛出错误?

請教一下，promise 的功能，是怕 deferred 是 global 變數的時候會被外部影響，但如果是直接調用 $.Deferred 是不是就沒這個問題，像這樣寫

let roll = () => {
return $.Deferred((dfd) => {
setTimeout(() => {
dfd.resolve();
}, 2000);

$.when(roll()).then(() => {
console.log('all done');
// case2, alert success1, fail 1, fail 2
var dtd = $.Deferred(); // 新建一个Deferred对象
dtd.resolve('success');
dtd.then(function(msg){
alert( msg + ' 1');
return new $.Deferred().reject('fail');
}).fail(function(msg){
alert( msg + ' 1');
return new $.Deferred().resolve('success');
}).then(function(msg){
alert( msg + ' 2');
return msg;
}).fail(function(msg){
alert( msg + ' 2');
return msg;

这一段代码执行结果是 success1, fail 1, fail 2. 能解释一下否？

阮老师，我在使用你的react脚手架的github工程的时候，报错了WebpackOptionsValidationError: Invalid configuration object. Webpack has been in
itialised using a configuration object that does not match the API schema.我是在windows下开发的，所以直接下了zip包，没有使用git clone，然后运行了npm install npm start 就报错了。这个错误我定位了很久，但是实在是技术不到家，没办法排查出来。请问这个到底是什么原因？

var wait = function () {
var dtd = $.Deferred(); // 新建一个deferred对象
var tasks = function () {
alert("执行完毕！");
dtd.resolve(); // 改变deferred对象的执行状态
setTimeout(tasks, 1000);
return dtd;
$.when(wait())
.done(function () {
alert("哈哈，成功了！");
.fail(function () {
alert("出错啦！");
}());