讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

jQuery Deferred模块详解

浅晨吖_5159

浅晨吖_5159

发布时间:2016-06-01 09:54:09

|

938人浏览过

|

来源于php中文网

原创

什么Deferred 

根据jQuery的官方api文档的描述: jQuery.Deferred()是可链式调用的工具对象, 它能够注册回调函数到一个队列中, 依次调用该队列中的回调函数,并且能够将调链中上一个函数(同步或者异步)的返回状态传递到下一个回调函数中. 

jQuery.Deferred()背后的设计理念来自CommonJS Promises/A , jQuery.Deferred()基于这个理念实现,但并没有完全遵循其设计。其它语言或者框架,例如python和dojo中都有类似的实现。 

下面简单介绍一下 “Promises”的设计思想,目的在于下文介绍jQuery.Deferred()的API时,让大家能有一个理论上的了解。 

Promise, 中文可以理解为愿望,代表单个操作完成的最终结果。一个Promise拥有三种状态:分别是unfulfilled(未满足的)、fulfilled(满足的)、failed(失败的),fulfilled状态和failed状态都可以被监听。一个愿望可以从未满足状态变为满足或者失败状态,一旦一个愿望处于满足或者失败状态,其状态将不可再变化。这种“不可改变”的特性对于一个Promise来说非常的重要,它可以避免Promise的状态监听器修改一个Promise的状态导致别的监听器的行为异常。例如:一个监听fulfilled状态的监听器把Promise的状态修改为failed,那么将触发failed状态的监听器,而如果一个failed状态监听器又把Promise的状态设置为fulfilled,那么又将触发fulfilled状态的监听器,这样将导致死循环。另外一种理解Promise这种特性的方式是把Promise看成是javascript中的primative类型的变量,这种变量可以被传入被调用的函数中,但是不可以被调用函数所改变。 

每一个Promise对象都有一个方法:then(fulfilledHandler, errorHandler, progressHandler),用于监听一个Promise的不同状态。fulfilledHandler用于监听fulfilled事件,errorHandler用于监听failed事件,progressHandler用于监听progress事件。一个Promise不强制实现progress状态的事件监听(jQuery的Deferred就是一个Promise的实现,但没有实现对progress状态事件的处理)。 

then(...)函数中的fulfilledHandler和errorHandler的返回值是一个新的Promise对象, 以便能够链式调用then(...)函数。每一个回调函数在正常情况下返回的是处于fulfilled状态的Promise,如果该回调函数返回错误值,那么返回的Promise状态将会变为failed。 

【疑惑:】以上对于Promise的介绍基本由英文原文翻译而来。感觉英文原文中的描述有点矛盾。例如前面说一个Promise的状态只能从unfulfilled变为fulfilled或者failed,可是又在后面说一个回调函数如果失败,将会把一个Promise从fulfilled状态变为failed状态。还请读者阅读原文 自行甄别。 

幸好jQuery的Promise实现, Deferred,要清晰的多。下面将详细介绍jQuery.Deferred()的API。 
 

Deferred API介绍 

1. 构造函数 

//方式一:  
var deferred = $.Deferred();  
//方式二:使用new操作符号,一般不这样做,显得冗余  
var deferred = new $.Deferred();  
//方式三:传入一个函数作为回调函数,这个函数会在构造的Deferred对象返回前执行。该函数被传入要返回的Deferred对象作为参数  
//在函数内部this指向要返回的Deferred对象。  
var dfd = new $.Deferred(function(newDeferred){  
    this.then(function(){console.log("new deferred");});  
});  

 

2. deferred.promise() 和 .promise() 

这两个API语法几乎一样,但是有着很大的差别。deferred.promise()是Deferred实例的一个方法,他返回一个Deferred.Promise实例。一个Deferred.Promise对象可以理解为是deferred对象的一个视图,它只包含deferred对象的一组方法,包括:done(),then(),fail(),isResolved(), isRejected(), always(),这些方法只能观察一个deferred的状态,而无法更改deferred对象的内在状态。这非常适合于API的封装。例如一个deferred对象的持有者可以根据自己的需要控制deferred状态的状态(resolved或者rejected),但是可以把这个deferred对象的Promise对象返回给其它的观察者,观察者只能观察状态的变化绑定相应的回调函数,但是无法更改deferred对象的内在状态,从而起到很好的隔离保护作用。 

$(function(){  
    //  
    var deferred = $.Deferred();  
    var promise = deferred.promise();  
      
    var doSomething = function(promise) {  
        promise.done(function(){  
            alert('deferred resolved.');  
        });  
    };  
      
    deferred.resolve();  
    doSomething(promise);  
})  

deferred.promise()也可以接受一个object参数,此时传入的object将被赋予Promise的方法,并作为结果返回。 

// Existing object  
var obj = {  
  hello: function( name ) {  
    alert( "Hello " + name );  
  }  
},  
// Create a Deferred  
defer = $.Deferred();  
  
// Set object as a promise  
defer.promise( obj );  
  
// Resolve the deferred  
defer.resolve( "John" );  
  
// Use the object as a Promise  
obj.done(function( name ) {  
  this.hello( name ); // will alert "Hello John"  
}).hello( "Karl" ); // will alert "Hello Karl" 

 

接下来介绍.promise()方法。 

首先这不是Deferred实例的方法!该方法是jQuery实例的方法。该方法用于一组类型的动作(例如动画)全部完成后返回一个Promise对象,供事件监听器监听其状态并执行相应的处理函数。 

该方法接受两个可选参数:.promise( [type,] [target] ) 

type:队列的类型,默认值是fx,fx即jQuery对象的动画. 
targetObject :要赋予Promise行为的对象, 

这两个参数是可选的。其中第一个参数(我)目前除了fx还没有找到其他的值类型。因此一般都是用于动画的监控,在动画完成后做一些操作。 

例子:没有动画效果直接返回一个resolved状态的promise对象 

var div = $( "<div />" );  
  
div.promise().done(function( arg1 ) {  
  // 将会被马上触发  
  alert( this === div && arg1 === div );  
});  

例子:在动画效果全部完成后触发done()监听函数 

<!DOCTYPE html>  
<html>  
<head>  
  <style>  
div {  
  height: 50px; width: 50px;  
  float: left; margin-right: 10px;  
  display: none; background-color: #090;  
}  
</style>  
  <script src="http://code.jquery.com/jquery-latest.js"></script>  
</head>  
<body>  
    
<button>Go</button>  
<p>Ready...</p>  
<div></div>  
<div></div>  
<div></div>  
<div></div>  
<script>  
$("button").bind( "click", function() {  
  $("p").append( "Started...");  
  //每个div执行动画效果  
  $("div").each(function( i ) {  
    $( this ).fadeIn().fadeOut( 1000 * (i+1) );  
  });  
  //$("div")包含一组div,在所有的div都完成自己的动画效果后触发done()函数  
  $( "div" ).promise().done(function() {  
    $( "p" ).append( " Finished! " );  
  });  
});  
</script>  
  
</body>  
</html>  

 

3. deferred.then() 

用于给一个deferred对象添加监听器。该方法接受两个参数: 

deferred.then( doneCallbacks, failCallbacks ) 

doneCallbacks: 一个函数,或者是一组函数,在deferred被实现时调用 
failCallbacks: 一个函数,或者是一组函数,在deferred被拒绝时调用 

例子: 

jQuery 1.12.4
jQuery 1.12.4

jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本,由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用,尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。

下载
$.get("test.php").then(  
    function(){ alert("$.get succeeded"); },  
    function(){ alert("$.get failed!"); }  
);  

deferred.then()提供了一种方便的写法,让一个deferred在实现或者被拒绝时的监听函数可以写在一个api中。 

 

4. deferred.done() 

用于添加deferred被实现时的监听函数。该方法可以接收一到多个参数,每个参数都是一个函数或者一组函数。 

例子: 

$(function(){  
    var dfd = $.Deferred();  
    var func1 = function() {alert("1");};  
    var func2 = function() {alert("2");};  
      
    dfd.done(func1, [func1, func2], func2);  
    dfd.resolve();  
})  

 

5. deferred.fail() 

用于添加deferred失败时的监听函数。该方法可以接收一到多个参数,每个参数都是一个函数或者一组函数。 

$(function(){  
    var dfd = $.Deferred();  
    var func1 = function() {alert("1");};  
    var func2 = function() {alert("2");};  
      
    dfd.fail(func1, [func1, func2], func2);  
               //调用reject方法触发fail事件处理函数  
    dfd.reject();  
})  

 

6. deferred.reject() 和 deferred.rejectWith() 

这两个方法将一个Deferred对象的状态由未实现置为失败状态,将触发该deferred的fail回调函数。如果deferred的状态已经是“已实现”,那么将不生效。 

reject函数可以接收一个参数,用于传给deferred的failCallback。而deferred.rejectWith()额外接受一个参数context,作为在fail回调函数中this的值。 

例子:deferred.reject([args]) 

见5中的例子。 

例子:deferred.rejectWith(),指定context 

$(function(){  
    var dfd = $.Deferred();  
    dfd.fail(function(cause){  
        console.log(cause);  
        console.log(this.name);  
    });  
      
    dfd.rejectWith({name: 'demo'}, ["invalid input!"]);  
})   

 

Deferred的应用 

1)与$.when()一起调用 

$.when()提供了一种根据Defererred对象的状态来执行回调函数的办法。它接受一个或者多个Defeered对象。

$(function(){  
     $.when($.ajax('test.html')).then(function(data, textStatus, jqXHR){  
         console.log(data);  
     },function(){  
         alert('failure');  
     })  
});  

在只使用一个参数的情况下,$.when()和直接使用Deferred对象没有什么区别,它也返回一个Deferred对象。$.when()更大的作用在于使用多个Defeered对象时,此时$.when()返回一个包含所有Deferred状态的超级Deferred对象。并且如果有一个Deferred失败,那么这个超级Deferred的状态将为failed,只有在所有Deferred对象都实现时,返回的超级Deferred对象状态才为resolved。 

$(function(){  
                //假设test.html不存在,那么将调用fail回调函数,弹出alert对话框  
     $.when($.ajax('test.html'), $.ajax('test.html')).then(function(args1,args2){  
         console.log(args1);  
     },function(){  
         alert('failure');  
     })  
});  

这非常适用于以下的业务场景:当一个回调函数需要依赖多个ajax请求取回数据才能被触发的情况。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

160

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

120

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

100

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
jQuery官方API文档
jQuery官方API文档

共0课时 | 0人学习

jQuery 教程
jQuery 教程

共42课时 | 16.9万人学习

HTML+CSS基础与实战
HTML+CSS基础与实战

共132课时 | 19.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn