Метод jQuery - .ajaxError() - устанавливает обработчик Ajax события, когда Ajax-запрос завершен с ошибкой.

Главная » jQuery API » .ajaxError()

Категории: Ajax › Global Ajax Event Handlers

.ajaxError()

Устанавливает обработчик Ajax события, когда Ajax-запрос завершен с ошибкой.

Синтаксис и описание:

Добавлено в jQuery 1.0.ajaxError( handler( [event, XHR, ajaxOptions, thrownError] ) )
Метод .ajaxError() подключает функцию обратного вызова ко всем элементам набора jQuery, которая вызывается, когда Ajax-запрос завершен с ошибкой (если ответ сервера содержит код статуса, сообщающий об ошибке). См. Ajax события.

Возвращаемое значение: (объект) Набор jQuery.

Параметры:

handler( [event, XHR, ajaxOptions, thrownError] ) – (функция) Функция обратного вызова - обработчик Ajax-события неудачного завершения запроса (ajaxError). Контекст функции this ссылается на текущий элемент DOM. Функция получает четыре аргумента:
1. event - экземпляр объекта JavaScript, свойство type которого имеет значение 'ajaxError' (название типа произошедшего Ajax события), а свойство target ссылается на текущий DOM элемент;
2. XHR - экземпляр объекта XMLHttpRequest;
3. ajaxOptions - объект, свойства которого являются параметрами запроса, использованными функцией $.ajax();
4. thrownError - объект-исключение, если во время запроса произошла и была определена исключительная ситуация (ошибка JavaScript).

Примечание:

Все обработчики события ajaxError вызываются при неудачном завершении любого запроса Ajax, независимо от того, какой это был запрос. Если же необходимо реагировать на разные запросы по разному, то их различие всегда можно определить, используя параметры (event, XHR, ajaxOptions и thrownError), переданные обработчику. В них будет находиться полная информация о выполненном с ошибкой запросе Ajax.

Примеры:

// Если Ajax запрос завершен с ошибкой, то содержимое элемента 
// с классом 'log' заменить на текст 'Событие ajaxError.'

$('.log').ajaxError(function() {
  $(this).text('Событие ajaxError.');
 });

[ наверх ]

www.jQueryBook.ru - jQuery документация

.ajaxError()

Устанавливает обработчик Ajax события, когда Ajax-запрос завершен с ошибкой.

Добавлено в jQuery 1.0.ajaxError( handler( [event, XHR, ajaxOptions, thrownError] ) )