当前位置: 首页 > 中文手册 > jQuery.ajaxError() 函数详解

jQuery.ajaxError() 函数详解

ajaxError()函数用于设置当AJAX请求失败时执行的回调函数

这是一个全局AJAX事件函数,用于为任何AJAX请求的ajaxError事件绑定事件处理函数。当AJAX请求失败时(例如:找不到页面、服务器内部错误、数据解析失败等),将触发ajaxError事件,并执行绑定的事件处理函数。

该函数必须在jQuery对象实例上调用,ajaxError()将为每个匹配元素的ajaxError事件绑定处理函数。当AJAX请求失败后,所有匹配元素上的处理函数都将被触发执行。事件处理函数内的this将指向当前DOM元素。

你可以在同一元素多次调用该函数,从而绑定多个事件处理函数。触发ajaxError事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

请注意,跨域"script"跨域"JSONP"请求不会调用ajaxError事件的事件处理函数。

jQuery 1.8开始,该函数只能document对象的ajaxError事件绑定处理函数,为其他元素绑定的事件处理函数不会起作用。

如果在jQuery.ajax()jQuery.ajaxSetup()中将选项参数global设为false,可以禁止该AJAX请求触发全局的AJAX事件。

该函数属于jQuery对象(实例)。

语法

jQuery 1.0 新增该函数。

jQueryObject.ajaxError( handler )

参数

参数描述
handlerFunction类型触发该事件时,需要执行的事件处理函数。

回调函数handler有4个参数:

  • 其一是表示当前事件的Event对象;
  • 其二是发送当前AJAX请求的jqXHR对象
  • 其三是表示本次AJAX请求的所有参数设置(包括无需指定的默认参数选项)的Object对象;
  • 其四是错误信息字符串(响应状态的文本描述部分,例如'Not Found'或'Internal Server Error')。

jqXHR对象就是经过jQuery封装的类似XMLHttpRequest的对象。

返回值

ajaxError()函数的返回值为jQuery类型,返回当前jQuery对象本身。

示例&说明

请参考以下HTML示例代码:

<div id="content1">CodePlayer</div>
<div id="content2">专注于编程开发技术分享</div>
<div id="content3">http://www.365mini.com</div>

以下是与ajaxError()函数相关的jQuery示例代码,以演示ajaxError()函数的具体用法:

以下代码请基于1.8之前版本的jQuery来运行(请注意,通过ajaxError()设置的全局事件处理函数与通过$.ajax()error选项设置的局部事件处理函数,它们的参数是不同的)。

//当前 jQuery版本:1.7.2 (必须是1.8之前的版本)

$("div").ajaxError( function(event, jqXHR, options, errorMsg){
	alert("处理函数1: 当前元素的id为" + this.id + ",请求的url为" + options.url);
} );

$("div").ajaxError( function(event, jqXHR, options, errorMsg){
	alert("处理函数2:请求方式为" + options.type + ",错误描述为" + errorMsg);
} );


// 执行该AJAX请求,会弹出6次对话框
// 因为当前页面有3个div元素,我们为每个div元素绑定了2个事件处理函数
$.ajax( {
	url: "index.html"
} );


// 执行该AJAX请求,会弹出7次对话框
// 因为$.ajax()自己通过error选项绑定了一个局部的ajaxError事件处理函数,它会执行一次
// 当前页面还有3个div元素,我们为每个div元素绑定了2个事件处理函数
// 因此总共弹出7次对话框
$.ajax( {
	url: "myurl" ,
	error: function(jqXHR, textStatus, errorMsg){
		// jqXHR 是经过jQuery封装的XMLHttpRequest对象
		// textStatus 可能为null、 'timeout'、 'error'、 'abort'和'parsererror'等
		// errorMsg 是错误信息字符串(响应状态的文本描述部分,例如'Not Found'或'Internal Server Error')

		alert( "error:" + errorMsg );
	}
} );

如果当前jQuery为1.8及以上版本,上述jQuery代码总共只会弹出一次对话框。因为从jQuery 1.8开始,ajaxError事件的处理函数必须绑定到document对象上才能生效。

因此,不论当前jQuery为何版本,如果不是特殊需求,我们都应该将ajaxError事件的处理函数绑定到document对象上。

$(document).ajaxError( function(event, jqXHR, options, errorMsg){
	alert("处理函数1:请求的url为" + options.url);
} );

$(document).ajaxError( function(event, jqXHR, options, data){
	alert("处理函数2:请求方式为" + options.type + ",错误描述为" + errorMsg);
} );


// 执行该AJAX请求,会弹出2次对话框
// 因为document对象上绑定了2个事件处理函数
$.ajax( {
	url: "index.html"
//	, global: false // 可以禁止触发全局的Ajax事件
} );


// 执行该AJAX请求,会弹出3次对话框
// 因为$.ajax()自己通过error选项绑定了一个局部的ajaxError事件处理函数,它会执行一次
// 我们还通过ajaxError()额外绑定了两个事件处理函数,会再弹出2次
$.ajax( {
	url: "myurl" ,
	error: function(jqXHR, textStatus, errorMsg){
		// jqXHR 是经过jQuery封装的XMLHttpRequest对象
		// textStatus 可能为null、 'timeout'、 'error'、 'abort'和'parsererror'等
		// errorMsg 是错误信息字符串(响应状态的文本描述部分,例如'Not Found'或'Internal Server Error')

		alert( "error:" + errorMsg );
	}
	//, global: false // 可以禁止触发全局的Ajax事件
} );
17 1
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

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

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

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