jQuery 中的 Deferred 和 Promises

news/2024/7/10 22:40:05 标签: jQuery, Deferred, Promises

  看前首先了解: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提供了一些增强的方式来管理回调,提供更加灵活的方式建立回调,而不用关心原始的回调是否已经触发。 jQueryDeferred对象支持多个回调绑定多个任务,任务本身既可以是同步也可以是异步的。

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

<div id="render-me"></div>
<div id="error" style="display:none;"></div>
$.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()方法。所以我们可以这样写:

<div id="render-me"></div>
<div id="error" style="display:none;"></div>
$.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!'); });

  或者这样写:

<div id="render-me"></div>
<div id="error" style="display:none;"></div>
$.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对象可以看下面这个表格。

  具体查看API http://www.css88.com/jqapi-1.9/category/deferred-object/;

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

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

 

二.灵活的 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()方法时,该回调函数将执行。它的用意是提供一个接口,使得在非同步操作执行过程中,可以执行某些操作,比如定期返回进度条的进度。

var userProgress = $.Deferred();
    var $profileFields = $("input");
    var totalFields = $profileFields.length
    userProgress.progress(function (filledFields) {
        var pctComplete = (filledFields/totalFields)*100;
        $("#progress").html(pctComplete.toFixed(0));
    }); 
    userProgress.done(function () {
        $("#thanks").html("Thanks for completing your profile!").show();
    });
    $("input").on("change", function () {
        var filledFields = $profileFields.filter("[value!='']").length;
        userProgress.notify(filledFields);
        if (filledFields == totalFields) {
            userProgress.resolve();
        }
    });

then()

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

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

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

var defer = jQuery.Deferred();
defer.done(function(a,b){
            return a * b;
}).done(function( result ) {
            console.log("result = " + result);
}).then(function( a, b ) {
            return a * b;
}).done(function( result ) {
            console.log("result = " + result);
}).then(function( a, b ) {
            return a * b;
}).done(function( result ) {
            console.log("result = " + result);
});
defer.resolve( 2, 3 );

  在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()方法。

var myDeferred = $.post('/echo/json/', {json:JSON.stringify({'error':true})})
    .then(function (response) {
            if (response.error) {
                return $.Deferred().reject(response);
            }
            return response;
        },function () {
            return $.Deferred().reject({error:true});
        }
    );
myDeferred.done(function (response) {
        $("#status").html("Success!");
    }).fail(function (response) {
        $("#status").html("An error occurred");
    });

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方法后面立即运行。

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

function maybeAsync( num ) {
  var dfd = $.Deferred();
  if ( num === 1 ) {
    setTimeout(function() {
      dfd.resolve( num );
    }, 100);
    return dfd.promise();
  }
  return num;
}
$.when(maybeAsync(1)).then(function (resp){
  $('#target').append('<p>' + resp + '</p>');
});
$.when(maybeAsync(0)).then(function (resp){
  $('#target').append( '<p>' + resp + '</p>');
});

  上面代码表示,如果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对象。

function doSomethingLater(fn, time) {
  var dfd = $.Deferred();
  setTimeout(function() {
    dfd.resolve(fn());
  }, time || 0);
  return dfd.promise();
}
var promise = doSomethingLater(function (){
  console.log( '已经延迟执行' );
}, 100);

  自定义操作使用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对象的另一个优势是可以附加多个回调函数。

function doSomething(arg) {
  var dfr = $.Deferred();
  setTimeout(function() {
    dfr.reject("Sorry, something went wrong.");
  });
  return dfr;
}
doSomething("uh oh").done(function() {
  alert("Won't happen, we're erroring here!");
}).fail(function(message) {
  alert(message)
});

 

文章来源:http://www.css88.com/archives/4750/comment-page-1


http://www.niftyadmin.cn/n/1316315.html

相关文章

PHP MVC 中的MODEL层

Model层&#xff0c;就是MVC模式中的数据处理层&#xff0c;用来进行数据和商业逻辑的装封 三、实现你的Mode层 Model层&#xff0c;就是MVC模式中的数据处理层&#xff0c;用来进行数据和商业逻辑的装封&#xff0c;进行他的设计的时候设计到三个个概念:------Model类。是实体…

angular中的异常机制与异常之外的处理

在查阅angularjs的官方文档发现&#xff1a;文档中提到了throw异常 angular.module(exceptionOverride, []).factory($exceptionHandler, function() {return function(exception, cause) {exception.message (caused by " cause ");throw exception;}; }); 同时…

深究AngularJS——监听模型$watch

一.前言 1.$watch是scope内置的函数&#xff0c;它的作用是用来监听数据的变化。 2.$watch可监听哪些数据&#xff1f; 单个对象的属性 需要计算的结果&#xff08;函数&#xff09; 3. 语法: $scope.$watch(F,M,B); 二.对$watch参数的了解 F&#xff1a;要监听的数据&…

php编程常用经验

1、用单引号代替双引号来包含字符串&#xff0c;这样做会更快一些。因为PHP会在双引号包围的字符串中搜寻变量&#xff0c; 单引号则不会&#xff0c;注意&#xff1a;只有echo能这么做&#xff0c;它是一种可以把多个字符串当作参数的”函数”(译注&#xff1a;PHP手册中说ech…

深究AngularJS—如何获取input的焦点(自定义指令)

一.写在前面 关于如何获取input框、textarea等的焦点&#xff0c;网上有许多文章都只是会跟你说ng-focus这个内置指令。像这种解答&#xff0c;只能说明作者并为真正理解人家的需求。ng-focus是一个事件&#xff0c;跟原生JS&#xff08;JavaScript&#xff09;的onfocus是一样…

angular中的路由简单使用

在单页面应用程序中比如angular应用&#xff0c;我们需要根据url的变化(即&#xff1a;不同的请求)&#xff0c;来分配不同的资源。根据请求的URL来决定执行哪个模块&#xff0c;这个过程叫路由&#xff0c;同时&#xff0c;我们需要设计路由规则。 下面给出一个简单的小demo&a…

java学习日记-----------------------------弹弹球

好玩的小程序&#xff0c;弹弹弹.................... import java.awt.*;import javax.swing.*;import java.awt.event.*;import javax.swing.event.*; public class BallsCanvas extends Canvas implements ActionListener,FocusListener{private Ball balls[];private Timer…

单页面webApp和路由(ng-route)

路由($route)这个东西(也许可以加上$location)可以说是ng最重要的东西了&#xff0c;因为angular目前最重要的作用就是做单页面webApp&#xff0c;而路由这个东西是能做到页面跳转的关键。 一.单页面webApp 为什么叫单页面webApp&#xff1f;因为它是单页面的。额&#xff0c;关…