.ajaxComplete()

.ajaxComplete()

.ajaxComplete( handler )Returns: jQuery

Description: Register a handler to be called when Ajax requests complete. This is an AjaxEvent.

Whenever an Ajax request completes, jQuery triggers the ajaxComplete event. Any and all handlers that have been registered with the .ajaxComplete() method are executed at this time.

To observe this method in action, set up a basic Ajax load request:

<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log"></div>

Attach the event handler to the document:

$( document ).ajaxComplete(function() {
  $( ".log" ).text( "Triggered ajaxComplete handler." );
});

Now, make an Ajax request using any jQuery method:

$( ".trigger" ).click(function() {
  $( ".result" ).load( "ajax/test.html" );
});

When the user clicks the element with class trigger and the Ajax request completes, the log message is displayed.

All ajaxComplete handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxComplete handler is executed, it is passed the event object, the XMLHttpRequest object, and the settings object that was used in the creation of the request. For example, you can restrict the callback to only handling events dealing with a particular URL:

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

Note: You can get the returned Ajax contents by looking at xhr.responseText.

Additional Notes:

  • As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with the .ajaxComplete() method, must be attached to document.
  • If $-ajax() or $.ajaxSetup() is called with the global option set to false, the .ajaxComplete() method will not fire.

Example:

Show a message when an Ajax request completes.

$( document ).ajaxComplete(function( event, request, settings ) {
  $( "#msg" ).append( "<li>Request Complete.</li>" );
});

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/ajaxComplete

在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部