.ajaxSuccess( handler(event, XMLHttpRequest, ajaxOptions) ) Returns: jQuery
Description: Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
-
version added: 1.0.ajaxSuccess( handler(event, XMLHttpRequest, ajaxOptions) )
-
handler(event, XMLHttpRequest, ajaxOptions)Type: Function()The function to be invoked.
-
Whenever an Ajax request completes successfully, jQuery triggers the ajaxSuccess
event. Any and all handlers that have been registered with the .ajaxSuccess()
method are executed at this time.
To observe this method in action, set up a basic Ajax load request:
1
2
3
|
|
Attach the event handler to any element:
1
2
3
|
|
Now, make an Ajax request using any jQuery method:
1
2
3
|
|
When the user clicks the element with class trigger
and the Ajax request completes successfully, the log message is displayed.
Note: Because .ajaxSuccess()
is implemented as a method of jQuery object instances, use the this
keyword to refer to the selected elements within the callback function. As of jQuery 1.8, however, the .ajaxSuccess()
method should only be attached to document
.
All ajaxSuccess
handlers are invoked, regardless of what Ajax request was completed. If you must differentiate between the requests, you can use the parameters passed to the handler. Each time an ajaxSuccess
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:
1
2
3
4
5
6
|
|
Note: You can get the returned ajax contents by looking at xhr.responseXML
or xhr.responseText
for xml and html respectively.
Additional Notes:
- If
$.ajax()
or$.ajaxSetup()
is called with theglobal
option set tofalse
, the.ajaxSuccess()
method will not fire.
Example:
Show a message when an Ajax request completes successfully.
1
2
3
|
|