# .ajaxComplete()

## ajaxComplete ( handler(event, XMLHttpRequest, ajaxOptions) ) Returns: jQuery version added: 1.0

- handler(event, XMLHttpRequest, ajaxOptions)
  Type: Function
  The function to be invoked.

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.

As of jQuery 1.8, the `.ajaxComplete()` method should only be attached to `document`.

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.responseHTML );
      }
    });

Note: You can get the returned ajax contents by looking at `xhr.responseXML` or `xhr.responseHTML` for xml and html respectively.

## Examples:

#### Example: Show a message when an Ajax request completes.

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