jQuery 中的 Deferred 和 Promises

- 日理万妓 2022-04-06 10:54 200阅读 0赞

看前首先了解：Promises/A规范，具体可以看这里，http://bijian1013.iteye.com/blog/2392429

由于jQuery版本问题对Deferred对象的实现有所不同，具体请参照[jQuery api][]。

jQuery.Deferred()基于Promises/A规范实现，因为jQuery本身的设计风格，jQuery.Deferred()并没有完全遵循Promises/A规范。

jQuery在1.5版本中首次引入了Deferred。你可以通过jQuery.Deferred() 在未来某个时候 得到 ‘延时’返回值。 在此之前是无法单独使用的，Deferred作为对ajax模块较大重写的一部分添加进来。1.5和1.6版本包含deferred功能，可以使$.ajax() 接收调用完成及请求出错的回调，但却存在严重的耦合。新版本的jQuery提供了一些增强的方式来管理回调，提供更加灵活的方式建立回调，而不用关心原始的回调是否已经触发。 jQuery的Deferred对象支持多个回调绑定多个任务，任务本身既可以是同步也可以是异步的。

举个简单地例子，原来我们写异步的ajax请求是这么写：

$.ajax({
        url : '/echo/json/',
        dataType:"json",
        type:"POST",
        data : {json:JSON.stringify({'name':"愚人码头"})},
        success : function (data) { 
            $("#render-me").html(data.name);
        },
        error : function () { alert('gulp!'); }
    });

从 jQuery 1.5 开始，$.ajax()返回的jqXHR对象 实现了 Promise 接口, 使它拥有了 Promise 的所有属性，方法和行为。（见Deferred object获取更多信息）。为了让回调函数的名字统一，便于在$.ajax()中使用。jqXHR也提供.error() .success()和.complete()方法。所以我们可以这样写：

$.ajax({
        url : '/echo/json/',
        dataType:"json",
        type:"POST",
        data : {json:JSON.stringify({'name':"愚人码头"})}
    }).success (function (data) { 
        $("#render-me").html(data.name);
    }).error(function () { alert('gulp!'); });

或者这样写：

$.ajax({
        url : '/echo/json/',
        dataType:"json",
        type:"POST",
        data : {json:JSON.stringify({'name':"愚人码头"})}
    }).done (function (data) { 
        $("#render-me").html(data.name);
    }).fail(function () { alert('gulp!'); });

**一.jQuery.Deferred对象**

了解jQuery.Deferred对象可以看下面这个表格。

![e3483c0c-6f3e-3627-a5bd-a810eac0f6f9.png][]

具体查看API [http://www.css88.com/jqapi-1.9/category/deferred-object/][jQuery api]；

jQuery延时实现的核心是jQuery.Deferred：一个可以链式调用的构造函数。…… 需要注意的是任何deferred对象的默认状态是unresolved， 回调会通过 .then() 、 .fail()等方法添加到队列，并在稍后的过程中被执行。

下面这张表格列举了，哪些事件会触发哪些回调：

![3094d6f4-8835-3507-a086-e07382f148d7.png][]

**二.灵活的 jQuery.Deferred对象**

**$.deferred()方法**

作用是生成一个deferred对象。

var deferred = $.deferred();

**done() 和 fail()**

这两个方法都用来绑定回调函数。done()指定非同步操作成功后的回调函数，fail()指定失败后的回调函数。

var deferred = $.Deferred();
    deferred.done(function(value) {
       alert(value);
    });

它们返回的是原有的deferred对象，因此可以采用链式写法，在后面再链接别的方法（包括done和fail在内）。

**resolve() 和 reject()**

这两个方法用来改变deferred对象的状态。resolve()将状态改为非同步操作成功，reject()改为操作失败。

var deferred = $.Deferred();
    deferred.done(function(value) {
       alert(value);
    });
    deferred.resolve("hello world");

一旦调用resolve()，就会依次执行done()和then()方法指定的回调函数；一旦调用reject()，就会依次执行fail()和then()方法指定的回调函数。

**state方法**

该方法用来返回deferred对象目前的状态。

var deferred = new $.Deferred();
    deferred.state();  // "pending"
    deferred.resolve();
    deferred.state();  // "resolved"

该方法的返回值有三个：

pending：表示操作还没有完成。

resolved：表示操作成功。

rejected：表示操作失败。

**notify() 和 progress()**

progress()用来指定一个回调函数，当调用notify()方法时，该回调函数将执行。它的用意是提供一个接口，使得在非同步操作执行过程中，可以执行某些操作，比如定期返回进度条的进度。

**then()**

then()的作用也是指定回调函数，它可以接受三个参数，也就是三个回调函数。第一个参数是resolve时调用的回调函数，第二个参数是reject时调用的回调函数，第三个参数是progress()方法调用的回调函数。

deferred.then( doneFilter \[, failFilter \] \[, progressFilter \] )

在jQuery 1.8之前，then()只是.done().fail()写法的语法糖，两种写法是等价的。在jQuery 1.8之后，then()返回一个新的deferred对象，而done()返回的是原有的deferred对象。如果then()指定的回调函数有返回值，该返回值会作为参数，传入后面的回调函数。

在jQuery 1.8版本之前，上面代码的结果是：

result = 2 
    result = 2 
    result = 2

在jQuery 1.8版本之后，返回结果是

result = 2 
    result = 6 
    result = NaN

这一点需要特别引起注意。

$.ajax( url1, { dataType: "json" } )
    .then(function( data ) {
        return $.ajax( url2, { data: { user: data.userId } } );
    }).done(function( data ) {
      // 从url2获取的数据
    });

上面代码最后那个done方法，处理的是从url2获取的数据，而不是从url1获取的数据。

利用then()会修改返回值这个特性，我们可以在调用其他回调函数之前，对前一步操作返回的值进行处理。

var post = $.post("/echo/json/")
        .then(function(p){
            return p.firstName;
        });
    post.done(function(r){ console.log(r); });

上面代码先使用then()方法，从返回的数据中取出所需要的字段（firstName），所以后面的操作就可以只处理这个字段了。

有时，Ajax操作返回json字符串里面有一个error属性，表示发生错误。这个时候，传统的方法只能是通过done()来判断是否发生错误。通过then()方法，可以让deferred对象调用fail()方法。

**always()**

always()也是指定回调函数，不管是resolve或reject都要调用。

**pipe方法**

pipe方法接受一个函数作为参数，表示在调用then方法、done方法、fail方法、always方法指定的回调函数之前，先运行pipe方法指定的回调函数。它通常用来对服务器返回的数据做初步处理。

**promise对象**

大多数情况下，我们不想让用户从外部更改deferred对象的状态。这时，你可以在deferred对象的基础上，返回一个针对它的promise对象。我们可以把后者理解成，promise是deferred的只读版，或者更通俗地理解成promise是一个对将要完成的任务的承诺。

你可以通过promise对象，为原始的deferred对象添加回调函数，查询它的状态，但是无法改变它的状态，也就是说promise对象不允许你调用resolve和reject方法。

function getPromise(){
        return $.Deferred().promise();
    }
    try{
        getPromise().resolve("a");
    } catch(err) {
        console.log(err);
    }

上面的代码会出错，显示TypeError \{\} 。

jQuery的ajax() 方法返回的就是一个promise对象。此外，Animation类操作也可以使用promise对象。

var promise = $('div.alert').fadeIn().promise();

**$.when()方法**

$.when()接受多个deferred对象作为参数，当它们全部运行成功后，才调用resolved状态的回调函数，但只要其中有一个失败，就调用rejected状态的回调函数。它相当于将多个非同步操作，合并成一个。

$.when(
        $.ajax( "/main.php" ),
        $.ajax( "/modules.php" ),
        $.ajax( "/lists.php" )
    ).then(successFunc, failureFunc);

上面代码表示，要等到三个ajax操作都结束以后，才执行then方法指定的回调函数。

when方法里面要执行多少个操作，回调函数就有多少个参数，对应前面每一个操作的返回结果。

$.when(
        $.ajax( "/main.php" ),
        $.ajax( "/modules.php" ),
        $.ajax( "/lists.php" )
    ).then(function (resp1, resp2, resp3){
        console.log(resp1);
        console.log(resp2);
        console.log(resp3);
    });

上面代码的回调函数有三个参数，resp1、resp2和resp3，依次对应前面三个ajax操作的返回结果。

when方法的另一个作用是，如果它的参数返回的不是一个Deferred或Promise对象，那么when方法的回调函数将 立即运行。

$.when({testing: 123}).done(function (x){
      console.log(x.testing); // "123"
    });

上面代码中指定的回调函数，将在when方法后面立即运行。

利用这个特点，我们可以写一个具有缓存效果的异步操作函数。也就是说，第一次调用这个函数的时候，将执行异步操作，后面再调用这个函数，将会返回缓存的结果。

上面代码表示，如果maybeAsync函数的参数为1，则执行异步操作，否则立即返回缓存的结果。

**wait方法**

我们可以用deferred对象写一个wait方法，表示等待多少毫秒后再执行。

$.wait = function(time) {
      return $.Deferred(function(dfd) {
        setTimeout(dfd.resolve, time);
      });
    }

使用方法如下：

$.wait(5000).then(function() {
      alert("Hello from the future!");
    });

改写setTimeout方法

在上面的wait方法的基础上，还可以改写setTimeout方法，让其返回一个deferred对象。

自定义操作使用deferred接口

我们可以利用deferred接口，使得任意操作都可以用done()和fail()指定回调函数。

Twitter = {
      search:function(query) {
        var dfr = $.Deferred();
        $.ajax({
         url:"http://search.twitter.com/search.json",
         data:{q:query},
         dataType:'jsonp',
         success:dfr.resolve
        });
        return dfr.promise();
      }
    }

使用方法如下：

Twitter.search('intridea').then(function(data) {
      alert(data.results[0].text);
    });

deferred对象的另一个优势是可以附加多个回调函数。

文章来源：[http://www.css88.com/archives/4750/comment-page-1][http_www.css88.com_archives_4750_comment-page-1]

[jQuery api]: http://www.css88.com/jqapi-1.9/category/deferred-object/
[e3483c0c-6f3e-3627-a5bd-a810eac0f6f9.png]: /images/20220406/8faf67bb44204c0fae947a8aa6a328ee.png
[3094d6f4-8835-3507-a086-e07382f148d7.png]: /images/20220406/f8295a8f33bf4c19af47fd9d872177cc.png
[http_www.css88.com_archives_4750_comment-page-1]: http://www.css88.com/archives/4750/comment-page-1