用法
.ajaxError( handler ) => jQuery
.ajaxError( handler ) => jQuery
说明:注册一个在 Ajax 请求完成并出现错误时调用的处理程序。这是个阿贾克斯事件.
-
添加的版本:1.0
.ajaxError( handler )
-
handler类型:Function(Event事件,jqXHRjqXHR,PlainObjectajaxSettings,String throwedError)要调用的函数。
-
每当 Ajax 请求完成并出现错误时,jQuery 都会触发ajaxError
事件。任何和所有已注册的处理程序.ajaxError()
方法在这个时候被执行。注意: This handler is not called for cross-domain script and cross-domain JSONP requests.
要观察此方法的实际效果,请设置一个基本的 Ajax 加载请求。
|
将事件处理程序附加到文档:
|
现在,使用任何 jQuery 方法发出 Ajax 请求:
|
当用户单击按钮并且 Ajax 请求失败时,由于请求的文件丢失,将显示日志消息。
无论完成了什么 Ajax 请求,都会调用所有 ajaxError
处理程序。要区分请求,请使用传递给处理程序的参数。每次执行 ajaxError
处理程序时,都会传递事件对象、jqXHR
对象(在 jQuery 1.5 之前,XHR
对象)和用于创建请求的设置对象。发生 HTTP 错误时,第四个参数 (thrownError
) 接收 HTTP 状态的文本部分,例如 "Not Found" 或“内部服务器错误”。例如,要将错误回调限制为仅处理处理特定 URL 的事件:
|
其他注意事项:
- 从 jQuery 1.9 开始,jQuery global Ajax events 的所有处理程序,包括使用
.ajaxError()
方法添加的处理程序,must
都附加到document
。 - 如果在
global
选项设置为false
的情况下调用$.ajax()
或$.ajaxSetup()
,则不会触发.ajaxError()
方法。
例子:
当 Ajax 请求失败时显示一条消息。
|
相关用法
- JQuery .ajaxSend()用法及代码示例
- JQuery .ajaxStop()用法及代码示例
- JQuery .ajaxComplete()用法及代码示例
- JQuery .ajaxSuccess()用法及代码示例
- JQuery .ajaxStart()用法及代码示例
- JQuery .add()用法及代码示例
- JQuery UI .addClass()用法及代码示例
- JQuery .addClass()用法及代码示例
- JQuery .addBack()用法及代码示例
- JQuery .animate()用法及代码示例
- JQuery .attr()用法及代码示例
- JQuery .after()用法及代码示例
- JQuery .append()用法及代码示例
- JQuery .appendTo()用法及代码示例
- JQuery .jquery用法及代码示例
- JQuery .scroll()用法及代码示例
- JQuery .contextmenu()用法及代码示例
- JQuery .undelegate()用法及代码示例
- JQuery .load()用法及代码示例
- JQuery .contents()用法及代码示例
- JQuery .empty()用法及代码示例
- JQuery UI .labels()用法及代码示例
- JQuery .click()用法及代码示例
- JQuery UI .toggleClass()用法及代码示例
- JQuery .removeAttr()用法及代码示例
注:本文由纯净天空筛选整理自jquery.com大神的英文原创作品 .ajaxError()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。