Урок - .ajaxError()

Группа вКонтакте
Лицензия: Лицензия Creative Commons.

Метод .ajaxError() регистрирует функцию для обработки ошибки во время Ajax-запроса. Метод .ajaxError() является Ajax-событием (Ajax-Event).

Синтаксис метода .ajaxError()

.ajaxComplete( handler(event, XMLHttpRequest, ajaxOptions, throwError) )

где

  • handler(event, XMLHttpRequest, ajaxOptions, throwError) - функция обратного вызова.
  • event - объект хранящий в себе параметры события.
    Список некоторых параметров:
    • type - будет равняться ajaxComplete.
    • timeStamp - временнеая метка запроса.
    • target - ссылка на вызывающий DOM-элемент.
  • XMLHttpRequest - XMLHttpRequest-объект.
    Некоторые из свойст XMLHttpRequest-объекта:
    • responseText - содержит полученный текст.
    • status - HTTP-код ответа.
  • ajaxOptions - объект хранящий в себе параметры AJAX-запроса.
    • url - URL-на страницу запроса.
    • type - метод HTTP-запроса.
    • async - синхронный или асинхронный запрос.
    • dataType - ожидаемый формат данных.
  • throwError - информация об исключении, если таковое было.

Метод .ajaxError() возвращает: jQuery-объект.

Внутри метода .ajaxError() ссылка this указывает на объект document.

Описание метода .ajaxError()

Все обработчики зарегистрированные методом .ajaxError() вызываются в случае возникновения ошибки в любом AJAX-запросе.

Метод .ajaxError() применим только к объекту document:

jQuery(document).ajaxError(function(event, xhr, settings, throwError) {
    ... код обработчика
});