Jquery jqXHR对象的属性和方法

在 jQuery 1.4 之前(包括1.4),$.ajax() 方法返回的是浏览器原生的 XMLHttpRequest 对象。

从 jQuery 1.5 开始,$.ajax() 方法返回 jQuery 自己的 XMLHttpRequest 对象(一般简称jqXHR)。之所以这样做,是因为 jQuery 1.5 引入了延迟对象 jQuery.Deferred,以便于更好地处理和执行回调函数。

你可以简单地理解为 jqXHR 对象是 jQuery 自己伪造的一个 XMLHttpRequest 对象和 $.Deferred 对象的结合体。

jqXHR是浏览器原生 XMLHttpRequest 对象的超集。例如,它也包含 responseText 和 responseXML 属性,以及 getResponseHeader() 方法。

当传输机制与 XMLHttpRequest 对象不同时(例如,用一个 <script> 标签来完成 JSONP 请求),jqXHR对象会尽可能地模拟本地 XMLHttpRequest 对象的功能。

从jQuery 1.5.1开始,jqXHR对象也支持 overrideMimeType() 方法(它在 1.4.x 中也可用,但在 1.5 中被临时移除)。overrideMimeType() 方法可用于 beforeSend() 的回调函数中,比如用来修改 Content-Type 响应头。

从jQuery 1.5开始,$.ajax() 返回的 jqXHR 对象实现了 Promise 接口,包括其所有的属性、方法和行为。因此,我们通过 jqXHR 可以非常简单地为本次 $.ajax() 绑定 AJAX 请求对应状态执行的回调函数。

我们通过解剖一个完整的 jqXHR 对象,来了解 jqXHR 对象的属性和方法:

var jqXHR = {
    abort: function (statusText){
        // 取消请求,关闭连接
    },
    always: function (){
        // 设置请求完成(无论成功或失败)时需要执行的一个或多个回调函数
    },
    complete: function (){
        // always()函数的别名,设置请求完成(无论成功或失败)时需要执行的一个或多个回调函数
    },
    done: function (){
        // 设置请求成功时需要执行的一个或多个回调函数
    },
    error: function (){
        // fail()函数的别名,设置请求失败时需要执行的一个或多个回调函数
    },
    fail: function (){
        // 设置请求失败时需要执行的一个或多个回调函数
    },
    getAllResponseHeaders: function (){
        // 获取响应头信息的原始字符串
    },
    getResponseHeader: function (key){
        // 获取响应头中指定名称的值
    },
    overrideMimeType: function (type){
        // 重写 Content-Type 响应头
    },
    pipe: function (){
        // then() 函数的别名,分别设置请求成功、失败、正在进行时需要执行的回调函数
    },
    progress: function (){
        // 设置 Deferred 对象生成进度通知时需要执行的回调函数
    },
    promise: function (obj){
        // 为指定对象追加 Promise 对象的成员,以充当 Promise 对象
    },
    readyState: 4, // 请求的状态
    responseText: "<!DOCTYPE html><html>......</html>", // 响应的文本内容
    setRequestHeader: function (name, value){
        // 设置请求头
    },
    state: function (){
        // 确定一个 Deferred 对象的当前状态,例如:"pending"、"resolved"、"rejected"
    },
    status: 200,
    statusCode: function (map){
        // 设置响应指定状态码需要执行的回调函数
        // map形如:{ 301:function(){}, 404:function(){} }
    },
    statusText: "OK", // 状态响应头中的描述文本
    success: function (){
        // done()函数的别名,设置请求成功时需要执行的一个或多个回调函数
    },
    then: function (){
        // 分别设置请求成功、失败、正在进行时需要执行的回调函数
    }
};

前面已经说了,我们通过 jqXHR 可以非常简单地为本次 $.ajax() 绑定 AJAX 请求对应状态执行的回调函数。

而 $.ajax() 方法执行完后会返回一个 jqXHR 对象。因为,我们其实大可以不在 $.ajax() 方法的参数中指定回调,转而使用链式写法,通过 jqXHR 对象的各个方法来指定回调。

像 $.get(),$.post() 这一类对 $.ajax() 进行了再封装的方法,方法本身的参数不支持设置 error 等回调,那么我们就可以用上面所说的方法来达到此目的。

//例1
$.ajax({
  url: ‘/some.js‘,
  type: ‘get‘,  dataType: ‘script‘}).success(function () {
  //...
}).error(function () {
  //...
})
//例2
$.get(‘/some.js‘, function () {
  //...
}, ‘script‘).error(function () {
  //...
})
时间: 2024-09-30 18:38:35

Jquery jqXHR对象的属性和方法的相关文章

jQuery事件对象的属性和方法

jQuery事件对象的属性和方法 事件对象的属于与方法有很多,但是我们经常用的只有那么几个,这里我主要说下作用与区别 event.type:获取事件的类型 触发元素的事件类型 $("a").click(function(event) { alert(event.type); // "click"事件 }); event.pageX 和 event.pageY:获取鼠标当前相对于页面的坐标 通过这2个属性,可以确定元素在当前页面的坐标值,鼠标相对于文档的左边缘的位置(

jQuery 事件对象的属性和方法

event.pageX 和 event.pageY:获取鼠标当前相对于页面的坐标 通过这 2 个属性,可以确定元素在当前页面的坐标值,鼠标相对于文档的左边缘的位置(左边)与 (顶边)的距离,简单来说是从页面左上角开始, 即是以页面为参考点, 不随滑动条移动而变化 event.preventDefault() 方法:阻止默认行为 这个用的特别多,在执行这个方法后,如果点击一个链接(a 标签),浏览器不会跳转到新的 URL 去了.我们可以用 event.isDefaultPrevented() 来确

JQuery修改对象的属性值

JQuery修改对象的属性值 用到的便是JQuery提供的attr方法,获取属性值的基本结构为:$(obj).attr("属性名"):修改属性值的结构为:$(obj).attr("属性名", "属性值"): <script type="text/javascript"> function ChangeObjAttrValue() { var objs = $("#first_div .mySpan&quo

关于JavaScript的对象,属性,方法的一些理解和认识。

对象      万物皆对象,所谓的对象,就是一个实体,一个物体,对象一定是有一个名字的, 在JavaScript中有很多很多对象,这些对象天生就存在在JavaScript中,比如document就是一个对象,window也是对象.     JavaScript想调用一个对象,非常的简单,直接打它的名字即可.     在JavaScript中,每个对象是负责不一样的事情.    document负责一切和文档相关的事情:window负责一切和浏览器窗口相关的事情:console负责一切和控制台相关

Javascript常用对象的属性和方法

javascript为我们提供了一些非常有用的常用内部对象和方法.用户不需要用脚本来实现这些功能.这正是基于对象编程的真正目的. 在javascript提供了string(字符串).math(数值计算)和Date(日期)三种对象和其它一些相关的方法.从而为编程人员快速开发强大的脚本程序提供了非常有利的条件. 1.常用内部对象 在javascript中对于对象属性与方法的引用,有两种情况:其一是说该对象是静态对象,即在引用该对象的属性或方法时不需要为它创建实例:而另一种对象则在引用它的对象或方法是

AJAX入门--- XMLHttpRequest对象的属性和方法

由于刚刚接触到Ajax对其比较陌生,而其中的XMLHttpRequest对象更是未曾听闻.开始学之前,了解一下它的属性和方法为它的使用做下铺垫.本文重点介绍XMLHttpRequest的属性和方法. XMLHttpRequest对象的属性和事件 属性 描述 readyState 表示XMLHttpRequest对象的状态[1] responseText 包含客户端接收到的HTTP相应的文本内容[2] responseXML 服务器响应的XML内容对应的DOM对象[3] status 服务器返回h

HTML DOM对象的属性和方法

HTML DOM对象的属性和方法 HTML DOM 对象有几种类型: 1.Document 类型 在浏览器中,Document 对象表示整个 HTML 文档. 1.1属性 引用文档的子节点 documentElement var html = document.documentElement; //取得对<html>元素的引用 body var body = document.body; //取得对<body>元素的引用 获取文档信息 title 通过 title 属性可以访问当前

&lt;JavaScript&gt; 六. window对象的属性和方法

1 <!DOCTYPE html> 2 <html> 3 <head> 4 <title></title> 5 <script type="text/javascript"> 6 /* 7 BOM: Browser Object Model 浏览器对象模型 8 提供了访问和操作浏览器各组件的方式 9 10 window: 浏览器窗口 JS中最大的对象, 其它对象都是它的子对象 11 location: 地址栏 12

HTML DOM对象的属性和方法介绍(原生JS方法)

HTML DOM对象的属性和方法介绍 DOM 是 Document Object Model(文档对象模型)的缩写. DOM(文档对象模型)是针对HTML和XML文档的一个API(应用程序编程接口),它允许程序和脚本动态地访问和更新文档的内容,结构和样式. W3C DOM 标准被分为 3 个不同的部分: 核心 DOM - 针对任何结构化文档的标准模型 XML DOM - 针对 XML 文档的标准模型 HTML DOM - 针对 HTML 文档的标准模型 HTML DOM 定义了所有 HTML 元