摘要：通常的做法是，為它們指定回調函數(shù)。指定操作成功時的回調函數(shù)指定操作失敗時的回調函數(shù)沒有參數(shù)時，返回一個新的對象，該對象的運行狀態(tài)無法被改變接受參數(shù)時，作用為在參數(shù)對象上部署接口。

jQuery的開發(fā)速度很快，幾乎每半年一個大版本，每兩個月一個小版本。

每個版本都會引入一些新功能。今天我想介紹的，就是從jQuery 1.5.0版本開始引入的一個新功能----deferred對象。

這個功能很重要，未來將成為jQuery的核心方法，它徹底改變了如何在jQuery中使用ajax。為了實現(xiàn)它，jQuery的全部ajax代碼都被改寫了。但是，它比較抽象，初學者很難掌握，網(wǎng)上的教程也不多。所以，我把自己的學習筆記整理出來了，希望對大家有用。

本文不是初級教程，針對的讀者是那些已經(jīng)具備jQuery使用經(jīng)驗的開發(fā)者。如果你想了解jQuery的基本用法，請閱讀我編寫的《jQuery設計思想》和《jQuery最佳實踐》。

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

jQuery的deferred對象詳解

作者：阮一峰

一、什么是deferred對象？

開發(fā)網(wǎng)站的過程中，我們經(jīng)常遇到某些耗時很長的javascript操作。其中，既有異步的操作（比如ajax讀取服務器數(shù)據(jù)），也有同步的操作（比如遍歷一個大型數(shù)組），它們都不是立即能得到結果的。

通常的做法是，為它們指定回調函數(shù)（callback）。即事先規(guī)定，一旦它們運行結束，應該調用哪些函數(shù)。

但是，在回調函數(shù)方面，jQuery的功能非常弱。為了改變這一點，jQuery開發(fā)團隊就設計了deferred對象。

簡單說，deferred對象就是jQuery的回調函數(shù)解決方案。在英語中，defer的意思是"延遲"，所以deferred對象的含義就是"延遲"到未來某個點再執(zhí)行。

它解決了如何處理耗時操作的問題，對那些操作提供了更好的控制，以及統(tǒng)一的編程接口。它的主要功能，可以歸結為四點。下面我們通過示例代碼，一步步來學習。

二、ajax操作的鏈式寫法

首先，回顧一下jQuery的ajax操作的傳統(tǒng)寫法：

　　$.ajax({

　　　　url: "test.html",

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

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

　　});

（運行代碼示例1）

在上面的代碼中，$.ajax()接受一個對象參數(shù)，這個對象包含兩個方法：success方法指定操作成功后的回調函數(shù)，error方法指定操作失敗后的回調函數(shù)。

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

現(xiàn)在，新的寫法是這樣的：

　　$.ajax("test.html")

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

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

（運行代碼示例2）

可以看到，done()相當于success方法，fail()相當于error方法。采用鏈式寫法以后，代碼的可讀性大大提高。

三、指定同一操作的多個回調函數(shù)

deferred對象的一大好處，就是它允許你自由添加多個回調函數(shù)。

還是以上面的代碼為例，如果ajax操作成功后，除了原來的回調函數(shù)，我還想再運行一個回調函數(shù)，怎么辦？

很簡單，直接把它加在后面就行了。

　　$.ajax("test.html")

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

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

　　.done(function(){ alert("第二個回調函數(shù)！");} );

（運行代碼示例3）

回調函數(shù)可以添加任意多個，它們按照添加順序執(zhí)行。

四、為多個操作指定回調函數(shù)

deferred對象的另一大好處，就是它允許你為多個事件指定一個回調函數(shù)，這是傳統(tǒng)寫法做不到的。

請看下面的代碼，它用到了一個新的方法$.when()：

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

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

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

（運行代碼示例4）

這段代碼的意思是，先執(zhí)行兩個操作$.ajax("test1.html")和$.ajax("test2.html")，如果都成功了，就運行done()指定的回調函數(shù)；如果有一個失敗或都失敗了，就執(zhí)行fail()指定的回調函數(shù)。

五、普通操作的回調函數(shù)接口（上）

deferred對象的最大優(yōu)點，就是它把這一套回調函數(shù)接口，從ajax操作擴展到了所有操作。也就是說，任何一個操作----不管是ajax操作還是本地操作，也不管是異步操作還是同步操作----都可以使用deferred對象的各種方法，指定回調函數(shù)。

我們來看一個具體的例子。假定有一個很耗時的操作wait：

　　var wait = function(){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　};

　　　　setTimeout(tasks,5000);

　　};

我們?yōu)樗付ɑ卣{函數(shù)，應該怎么做呢？

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

　　$.when(wait())

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

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

（運行代碼示例5）

但是，這樣寫的話，done()方法會立即執(zhí)行，起不到回調函數(shù)的作用。原因在于$.when()的參數(shù)只能是deferred對象，所以必須對wait()進行改寫：

　　var dtd = $.Deferred(); // 新建一個deferred對象

　　var wait = function(dtd){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.resolve(); // 改變deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　setTimeout(tasks,5000);

　　　　return dtd;

　　};

現(xiàn)在，wait()函數(shù)返回的是deferred對象，這就可以加上鏈式操作了。

　　$.when(wait(dtd))

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

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

（運行代碼示例6）

wait()函數(shù)運行完，就會自動運行done()方法指定的回調函數(shù)。

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

如果仔細看，你會發(fā)現(xiàn)在上面的wait()函數(shù)中，還有一個地方我沒講解。那就是dtd.resolve()的作用是什么？

要說清楚這個問題，就要引入一個新概念"執(zhí)行狀態(tài)"。jQuery規(guī)定，deferred對象有三種執(zhí)行狀態(tài)----未完成，已完成和已失敗。如果執(zhí)行狀態(tài)是"已完成"（resolved）,deferred對象立刻調用done()方法指定的回調函數(shù)；如果執(zhí)行狀態(tài)是"已失敗"，調用fail()方法指定的回調函數(shù)；如果執(zhí)行狀態(tài)是"未完成"，則繼續(xù)等待，或者調用progress()方法指定的回調函數(shù)（jQuery1.7版本添加）。

前面部分的ajax操作時，deferred對象會根據(jù)返回結果，自動改變自身的執(zhí)行狀態(tài)；但是，在wait()函數(shù)中，這個執(zhí)行狀態(tài)必須由程序員手動指定。dtd.resolve()的意思是，將dtd對象的執(zhí)行狀態(tài)從"未完成"改為"已完成"，從而觸發(fā)done()方法。

類似的，還存在一個deferred.reject()方法，作用是將dtd對象的執(zhí)行狀態(tài)從"未完成"改為"已失敗"，從而觸發(fā)fail()方法。

　　var dtd = $.Deferred(); // 新建一個Deferred對象

　　var wait = function(dtd){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.reject(); // 改變Deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　setTimeout(tasks,5000);

　　　　return dtd;

　　};

　　$.when(wait(dtd))

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

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

（運行代碼示例7）

七、deferred.promise()方法

上面這種寫法，還是有問題。那就是dtd是一個全局對象，所以它的執(zhí)行狀態(tài)可以從外部改變。

請看下面的代碼：

　　var dtd = $.Deferred(); // 新建一個Deferred對象

　　var wait = function(dtd){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.resolve(); // 改變Deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　setTimeout(tasks,5000);

　　　　return dtd;

　　};

　　$.when(wait(dtd))

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

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

　　dtd.resolve();

（運行代碼示例8）

我在代碼的尾部加了一行dtd.resolve()，這就改變了dtd對象的執(zhí)行狀態(tài)，因此導致done()方法立刻執(zhí)行，跳出"哈哈，成功了！"的提示框，等5秒之后再跳出"執(zhí)行完畢！"的提示框。

為了避免這種情況，jQuery提供了deferred.promise()方法。它的作用是，在原來的deferred對象上返回另一個deferred對象，后者只開放與改變執(zhí)行狀態(tài)無關的方法（比如done()方法和fail()方法），屏蔽與改變執(zhí)行狀態(tài)有關的方法（比如resolve()方法和reject()方法），從而使得執(zhí)行狀態(tài)不能被改變。

請看下面的代碼：

　　var dtd = $.Deferred(); // 新建一個Deferred對象

　　var wait = function(dtd){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.resolve(); // 改變Deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　setTimeout(tasks,5000);

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

　　};

　　var d = wait(dtd); // 新建一個d對象，改為對這個對象進行操作

　　$.when(d)

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

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

　　d.resolve(); // 此時，這個語句是無效的

（運行代碼示例9）

在上面的這段代碼中，wait()函數(shù)返回的是promise對象。然后，我們把回調函數(shù)綁定在這個對象上面，而不是原來的deferred對象上面。這樣的好處是，無法改變這個對象的執(zhí)行狀態(tài)，要想改變執(zhí)行狀態(tài)，只能操作原來的deferred對象。

不過，更好的寫法是allenm所指出的，將dtd對象變成wait(）函數(shù)的內部對象。

　　var wait = function(dtd){

　　　　var dtd = $.Deferred(); //在函數(shù)內部，新建一個Deferred對象

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.resolve(); // 改變Deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　setTimeout(tasks,5000);

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

　　};

　　$.when(wait())

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

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

（運行代碼示例10）

八、普通操作的回調函數(shù)接口（中）

另一種防止執(zhí)行狀態(tài)被外部改變的方法，是使用deferred對象的建構函數(shù)$.Deferred()。

這時，wait函數(shù)還是保持不變，我們直接把它傳入$.Deferred()：

　　$.Deferred(wait)

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

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

（運行代碼示例11）

jQuery規(guī)定，$.Deferred()可以接受一個函數(shù)名（注意，是函數(shù)名）作為參數(shù)，$.Deferred()所生成的deferred對象將作為這個函數(shù)的默認參數(shù)。

九、普通操作的回調函數(shù)接口（下）

除了上面兩種方法以外，我們還可以直接在wait對象上部署deferred接口。

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

　　var wait = function(dtd){

　　　　var tasks = function(){

　　　　　　alert("執(zhí)行完畢！");

　　　　　　dtd.resolve(); // 改變Deferred對象的執(zhí)行狀態(tài)

　　　　};

　　　　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對象的方法

前面已經(jīng)講到了deferred對象的多種方法，下面做一個總結：

　　（1） $.Deferred() 生成一個deferred對象。

　　（2） deferred.done() 指定操作成功時的回調函數(shù)

　?。?） deferred.fail() 指定操作失敗時的回調函數(shù)

　?。?） deferred.promise() 沒有參數(shù)時，返回一個新的deferred對象，該對象的運行狀態(tài)無法被改變；接受參數(shù)時，作用為在參數(shù)對象上部署deferred接口。

　?。?） deferred.resolve() 手動改變deferred對象的運行狀態(tài)為"已完成"，從而立即觸發(fā)done()方法。

　?。?）deferred.reject() 這個方法與deferred.resolve()正好相反，調用后將deferred對象的運行狀態(tài)變?yōu)?已失敗"，從而立即觸發(fā)fail()方法。

　?。?） $.when() 為多個操作指定回調函數(shù)。

除了這些方法以外，deferred對象還有二個重要方法，上面的教程中沒有涉及到。

　　（8）deferred.then()

有時為了省事，可以把done()和fail()合在一起寫，這就是then()方法。

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

　　.then(successFunc, failureFunc );

如果then()有兩個參數(shù)，那么第一個參數(shù)是done()方法的回調函數(shù)，第二個參數(shù)是fail()方法的回調方法。如果then()只有一個參數(shù)，那么等同于done()。

　?。?）deferred.always()

這個方法也是用來指定回調函數(shù)的，它的作用是，不管調用的是deferred.resolve()還是deferred.reject()，最后總是執(zhí)行。

　　$.ajax( "test.html" )

　　.always( function() { alert("已執(zhí)行！");} );