.ajaxStop( handler )Returns: jQuery
Description: Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
-
version added: 1.0.ajaxStop( handler )
- handlerType: Function()The function to be invoked.
-
Whenever an Ajax request completes, jQuery checks whether there are any other outstanding Ajax requests. If none remain, jQuery triggers the ajaxStop
event. Any and all handlers that have been registered with the .ajaxStop()
method are executed at this time. The ajaxStop
event is also triggered if the last outstanding Ajax request is cancelled by returning false within the beforeSend
callback function.
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 ).ajaxStop(function() { $( ".log" ).text( "Triggered ajaxStop 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.
Additional Notes:
- As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with the
.ajaxStop()
method, must be attached todocument
. - If
$.ajax()
or$.ajaxSetup()
is called with theglobal
option set tofalse
, the.ajaxStop()
method will not fire.
Example:
Hide a loading message after all the Ajax requests have stopped.
$( document ).ajaxStop(function() { $( "#loading" ).hide(); });