ajaxSend 事件


.on( "ajaxSend", handler )返回值: jQuery

描述: 在发送 Ajax 请求之前,附加一个要执行的函数。这是一个 Ajax 事件.

此页面描述了 ajaxSend 事件。对于已弃用的 .ajaxSend() 方法,请参见 .ajaxSend().

每当要发送 Ajax 请求时,jQuery 都会触发 ajaxSend 事件。此时会执行所有已注册的 ajaxSend 处理程序。

要观察此方法的实际操作,请设置一个基本的 Ajax 加载请求

1
2
3
<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log"></div>

将事件处理程序附加到文档

1
2
3
$( document ).on( "ajaxSend", function() {
$( ".log" ).text( "Triggered ajaxSend handler." );
} );

现在,使用任何 jQuery 方法发出 Ajax 请求

1
2
3
$( ".trigger" ).on( "click", function() {
$( ".result" ).load( "ajax/test.html" );
} );

当用户单击具有类 trigger 的元素并且 Ajax 请求即将开始时,将显示日志消息。

所有ajaxSend 处理程序都会被调用,无论要发送的是什么 Ajax 请求。如果您必须区分请求,请使用传递给处理程序的参数。每次执行ajaxSend 处理程序时,都会将事件对象、jqXHR 对象(在版本 1.4 中为XMLHttpRequest 对象)以及用于创建 Ajax 请求的设置对象 传递给它。例如,您可以将回调限制为仅处理与特定 URL 相关的事件。

1
2
3
4
5
$( document ).on( "ajaxSend", function( event, jqxhr, settings ) {
if ( settings.url == "ajax/test.html" ) {
$( ".log" ).text( "Triggered ajaxSend handler." );
}
} );

其他说明

  • 从 jQuery 1.9 开始,所有用于jQuery 全局 Ajax 事件 的处理程序(包括使用.on( "ajaxSend", ... ) 添加的处理程序)必须附加到document
  • 如果$.ajax()$.ajaxSetup() 被调用,并且global 选项设置为false,则ajaxSend 事件不会触发。

示例

在发送 Ajax 请求之前显示一条消息。

1
2
3
$( document ).on( "ajaxSend", function( event, request, settings ) {
$( "#msg" ).append( "<li>Starting request at " + settings.url + "</li>" );
} );