.on( "ajaxSend", handler )Returns: jQuery
Description: Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
-
version added: 1.7.on( "ajaxSend", handler )
-
"ajaxSend"Type: stringThe string
"ajaxSend"
. -
handlerThe function to be invoked.
-
This page describes the ajaxSend
event. For the deprecated .ajaxSend()
method, see .ajaxSend()
.
Whenever an Ajax request is about to be sent, jQuery triggers the ajaxSend
event. Any and all registerd ajaxSend
handlers 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 the document:
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 is about to begin, the log message is displayed.
All ajaxSend
handlers are invoked, regardless of what Ajax request is to be sent. If you must differentiate between the requests, use the parameters passed to the handler. Each time an ajaxSend
handler is executed, it is passed the event object, the jqXHR
object (in version 1.4, XMLHttpRequest
object), and the settings object that was used in the creation of the Ajax request. For example, you can restrict the callback to only handling events dealing with a particular URL:
1
2
3
4
5
|
|
Additional Notes:
-
As of jQuery 1.9, all the handlers for the jQuery global Ajax events, including those added with
.on( "ajaxSend", ... )
, must be attached todocument
. -
If
$.ajax()
or$.ajaxSetup()
is called with theglobal
option set tofalse
, theajaxSend
event will not fire.
Example:
Show a message before an Ajax request is sent.
1
2
3
|
|