全局 Ajax 事件

全局 Ajax 事件

必须当页面上存在任何ajax请求的时候都将触发这些特定的全局ajax处理函数。

如果在jQuery.ajaxSetup()中的global属性设置成true，那么这些全局函数将会在每一个ajax上面都触发，这正是默认值。

注意：

1.全局事件永远不会再跨域的脚本中运行，也不会再JSONP请求中运行。

2.在jQuery1.9以上，所有的全局ajax函数必须绑定扫到document上，也就是$(document).事件

3.只有在$.ajax()亦或$.ajaxSetup()中的globle设置成true才能使用ajax全局函数，false将不能使用。

在jQuery.ajaxSetup( options ) 中的options参数属性中,有一个global属性:

global

类型:布尔值

默认值: true

说明:是否触发全局的 Ajax 事件.

这个属性用来设置是否触发全局的 Ajax 事件。全局 Ajax 事件是一系列伴随 Ajax 请求发生的事件。主要有如下事件:

用一个示例讲解各个事件的触发顺序：

       
  
send Ajax request
 
  

我们可以通过将默认options的global属性设置为false来取消全局 Ajax 事件的触发。

针对每一个请求（per request）

$.ajaxComplete()

例子：

HTML代码：

Trigger

jquery代码：

$( document ).ajaxComplete(function() { 　　$( ".log" ).text( "Triggered ajaxComplete handler." ); }); $( ".trigger" ).click(function() { 　　$( ".result" ).load( "ajax/test.html" ); });

当用户点击class=trigger的元素的时候，加载html文件，请求完成之后class=log元素上显示信息。

无论什么Ajax请求完成，都将触发ajaxComplete事件，所以，你可以如下进行判断

$( document ).ajaxComplete(function( event, xhr, settings ) { if ( settings.url === "ajax/test.html" ) { $( ".log" ).text( "Triggered ajaxComplete handler. The result is " + xhr.responseText ); } });

语法形式

$(document).ajaxComplete(function(event,xhr,options))

所以上面进行指定ajax判断的时候使用的setting，也就是ajax request传递的对象，其中含有url属性，如果传递的url和需要判断的指定的url一样，则进行处理。

$.ajaxError()

$(document).ajaxError(function(event,xhr,options,exc))

当ajaxError事件被触发的时候，不管ajax请求是否完成。

每次执行ajaxerror事件的时候，传递了event对象，jqXHR对象（jQuery1.5之前是XHR对象），和用于请求的settings对象。

当HTTP error发生，第四个参数（thownError）接受了HTTP的状态的文本部分，例如“Not Found”亦或“Internal Server Error”

to restrict the error callback to only handling events dealing with a particular URL:

ajaxSend()

send()发送的时候发触发

ajaxSuccess()是请求成功时触发，注意和ajaxComplete不同的是，ajaxComplete是不管请求失败还是成功，只要完成了就执行。

针对一批请求

ajaxStart()，ajaxStop()

是针对文本中所有的ajax请求的，当第一个ajax请求发送时触发ajaxStart()事件，当最后一个ajax请求完成时，触发ajaxStop()事件，不同的是，ajaxSend()和ajaxComplete是针对文本中每一次的ajax请求的。

所以如果你在文本中一次使用了3个请求，ajaxStart()会在第一个请求发起时触发，ajaxStop()会在最后一个请求结束时触发，所以它们常常组合用于显示loading等待框等。因为他们处理的是一群ajax请求，所以它们的回调函数中没有任何参数

.ajaxStart( handler() )
.ajaxStop( handler() )