关于JQ的$.deferred函数。参考网络文档
由于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对象可以看下面这个表格。
jQuery.Deferred() |
创建一个新的Deferred对象的构造函数,可以带一个可选的函数参数,它会在构造完成后被调用。 |
jQuery.when() |
通过该方式来执行基于一个或多个表示异步任务的对象上的回调函数 |
jQuery.ajax() | 执行异步Ajax请求,返回实现了promise接口的jqXHR对象 |
deferred.then( doneFilter [, failFilter ] [, progressFilter ] ) | 当Deferred(延迟)对象解决,拒绝或仍在进行中时,调用添加处理程序。 |
deferred.done() | 当延迟成功时调用一个函数或者数组函数. |
deferred.fail() | 当延迟失败时调用一个函数或者数组函数.。 |
deferred.always() | 当Deferred(延迟)对象解决或拒绝时,调用添加处理程序。 |
deferred.resolve(ARG1,ARG2,…) | 调用Deferred对象注册的‘done’回调函数并传递参数 |
deferred.resolveWith(context,args) | 调用Deferred对象注册的‘done’回调函数并传递参数和设置回调上下文 |
deferred.isResolved | 确定一个Deferred对象是否已经解决。 |
deferred.reject(arg1,arg2,…) | 调用Deferred对象注册的‘fail’回调函数并传递参数 |
deferred.rejectWith(context,args) | 调用Deferred对象注册的‘fail’回调函数并传递参数和设置回调上下文 |
deferred.promise() | 返回promise对象,这是一个伪造的deferred对象:它基于deferred并且不能改变状态所以可以被安全的传递 |
具体查看API http://www.css88.com/jqapi-1.9/category/deferred-object/;
jQuery延时实现的核心是jQuery.Deferred:一个可以链式调用的构造函数。…… 需要注意的是任何deferred对象的默认状态是unresolved, 回调会通过 .then() 、 .fail()等方法添加到队列,并在稍后的过程中被执行。
下面这张表格列举了,哪些事件会触发哪些回调:
Callbacks\ Events→ ↓ |
deferred.always() | deferred.done() | deferred.fail() | deferred.progress() |
deferred.notify() | 触发 | |||
deferred.notifyWith() | 触发 | |||
deferred.reject() | 触发 | 触发 | ||
deferred.rejectWith() | 触发 | 触发 | ||
deferred.resolve() | 触发 | 触发 | ||
deferred.resolveWith() | 触发 | 触发 |
灵活的 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)
- });
关于JQ的$.deferred函数。参考网络文档的更多相关文章
- [转]unity3d 脚本参考-技术文档
unity3d 脚本参考-技术文档 核心提示:一.脚本概览这是一个关于Unity内部脚本如何工作的简单概览.Unity内部的脚本,是通过附加自定义脚本对象到游戏物体组成的.在脚本对象内部不同志的函数被 ...
- 连接SQLServer2005失败--[Microsoft][ODBC SQL Server Driver][DBNETLIB]一般性网络错误。请检查网络文档
连接SQLServer2005失败,错误信息: 错误类型:Microsoft OLE DB Provider for ODBC Drivers (0x80004005)[Microsoft][ODBC ...
- C语言函数库帮助文档
C语言函数库帮助文档 安装 1.C语言库函数基本的帮助文档 sudo apt-get install manpages sudo apt-get install manpages-de sudo ap ...
- 无法安装 VMware Tools。尝试访问安装 VMware Tools 所需的图像文件“/usr/lib/vmware/isoimages/linuxPreGlibc25.iso”时出错: 2 (No such file or directory)。请参考产品文档或知识库文章 2129825,了解关于如何获取该客户机操作系统的 VMware Tools 软件包的详细信息。
无法安装 VMware Tools.尝试访问安装 VMware Tools 所需的图像文件"/usr/lib/vmware/isoimages/linuxPreGlibc25.iso&quo ...
- jQuery 效果函数,jquery文档操作,jQuery属性操作方法,jQuerycss操作函数,jQuery参考手册-事件,jQuery选择器
jQuery 效果函数 方法 描述 animate() 对被选元素应用“自定义”的动画 clearQueue() 对被选元素移除所有排队的函数(仍未运行的) delay() 对被选元素的所有排队函数( ...
- R自动数据收集第二章HTML笔记1(主要关于handler处理器函数和帮助文档所有示例)
本文知识点: 1潜在畸形页面使用htmlTreeParse函数 2startElement的用法 3闭包 4handler函数的命令和函数体主要写法 5节点的丢弃,取出,取出标签名称.属性.属 ...
- cmd命令查看Python模块函数等帮助文档和介绍
dir函数式可以查看对象的属性 使用方法很简单,举os类型为例,在Python命令窗口输入 dir(‘os’) 即可查看os模块的属性 打开cmd命令窗口 输入python(注意:计算机需要有Py ...
- jQuery 参考手册 - 文档操作
上传图片时页面崩溃..全部付之东流 addClass() after() append() appendTo() attr() before() clone() detach() empty() ha ...
- C# 面试知识点网络文档整理
一 C# .NET技术 1.ASP.NET MVC如何控制权限? 2.C#.NET中的CTS.CLS和CLR? 3.什么是多线程,如何创建和如何使用?请写一个多线程单例模式? 4.什么是单例模式? 5 ...
随机推荐
- ubuntu安装配置jdk tomcat mysql ...
安装之前大家一定要检查好各个版本问题 以免造成不兼容. (一)下载所需安装包: jdk-7u76-linux-x64.tar.gz apache-tomcat-7.0.63.tar.gz MySQL- ...
- javascript平时小例子③(setInterval使用1)
<!DOCTYPE html><html> <head> <meta charset="UTF-8"> <title>& ...
- DBA日常工作内容和职责
1.统计数据库总容量 按表空间分别统计: 总容量(单位为M): 2.计算用户下所有对象大小 3计算USERS表空间的大小 4计算该USERS表空间对象大小 ---------------------- ...
- ajaxfileupload.js
jQuery.extend({ createUploadIframe: function(id, uri) { //create frame var frameId = 'jUploadFrame' ...
- css背景图片,bootstrap和jquery-ui结合使用,dialog案例
css将一个不能铺满整个屏幕的图片铺满整个屏幕,将一下代码放到body中 <img src="image/login6.jpg" width="100%" ...
- 一篇很全面的freemarker教程
以下内容全部是网上收集: FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成:1,文本:直接输出的部分2,注释:<#-- ... --& ...
- 使用方法:mail_sendmail($params)
使用方法:mail_sendmail($params) 类构造函数,$params是一个关联数组,你可以设定sendmail的参数,目前只有sendmail_path是有效的,用来设置sendmail ...
- 生成一行html
//压缩 一行html Regex regReplaceBlank = new Regex(">(\\s+)<", RegexOptions.IgnoreCase); ...
- 利用box-flex实现 dom元素位置页面底部
问题: 总是有这样的需求,就是页面上某部分要位于页面的最底部,此“最底部”要求:(1)当页面上内容不足一屏的时候,在最底部显示(2)当页面上内容不止一屏的时候,也就是有垂直滚动条的时候,要在内容的最后 ...
- angular+ckeditor最后上传的最后一张图片不会被添加(bug)
做法一: angularJs+ckeditor 一.页面 <textarea ckeditor required name="topicContent" ng-model=& ...