Справочник API
.ajaxSend() в jQuery
Содержание статьи
-
Категории: Ajax › Global Ajax Event Handlers
Устанавливает обработчик Ajax события, когда Ajax-запрос готов к отправке (перед самой отправкой).
Синтаксис и описание:
Добавлено в jQuery 1.0.ajaxSend( handler( [event, XHR, ajaxOptions] ) )
Метод .ajaxSend() подключает функцию обратного вызова ко всем элементам набора jQuery, которая вызывается, когда создан объект XMLHttpRequest и Ajax-запрос готов к отправке, но перед самой отправкой запроса на сервер (см. Ajax события).
Возвращаемое значение: (объект) Набор jQuery.
Параметры:
handler( [event, XHR, ajaxOptions] ) – (функция) Функция - обработчик Ajax события готовности запроса к отправке (ajaxSend), которое возникает, когда объект XHR создан и запрос вот-вот будет отправлен. Контекст функции this ссылается на текущий DOM элемент. Методу передаются три параметра:
- event - экземпляр объекта JavaScript, свойство type которого имеет значение 'ajaxSend' (название типа произошедшего Ajax события), а свойство target ссылается на текущий DOM элемент;
- XHR - экземпляр объекта XMLHttpRequest;
- ajaxOptions - объект со свойствами - параметрами запроса, которые были использованы функцией $.ajax().
-
Примечание:
Все обработчики события ajaxSend вызываются перед самой отправкой на сервер любого запроса Ajax, независимо от того, какой это был запрос. Если же необходимо реагировать на разные запросы по разному, то их различие всегда можно определить, используя параметры (event, XHR и ajaxOptions), переданные обработчику. В них будет находиться полная информация о запросе Ajax, который будет отправлен.
-
Примечание:
Несмотря на то, что событие ajaxSend наступает перед отправкой запроса, отменить отправку запроса (из функции-обработчика) в этот момент уже нельзя.
Примеры:
-
// По наступлению события готовности Ajax запроса перед // отправкой (ajaxSend) содержимое элемента с классом // 'log' заменить на текст 'Событие ajaxSend.' $('.log').ajaxSend(function() { $(this).text('Событие ajaxSend.'); });