当前位置: 首页 > 中文手册 > jQuery jqXHR对象的属性和方法

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对象的超集。例如,它也包含responseTextresponseXML属性,以及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 (){
		// 分别设置请求成功、失败、正在进行时需要执行的回调函数				
	}
};
50 1
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。