内容目录
在 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 (){
// 分别设置请求成功、失败、正在进行时需要执行的回调函数
}
};
0 条评论
撰写评论