Содержание:
.ajaxError( handler )Возвращает: jQuery
Описание: Регистрирует обработчик, который вызывается при завершении Ajax запросов с ошибкой. Является Ajax событием.
-
Добавлен в версии: 1.0.ajaxError( handler )
-
handlerФункция которая будет вызвана.
-
Всякий раз при завершении Ajax запроса с ошибкой, jQuery инициирует ajaxError
событие. Все обработчики зарегистрированные при помощи метода .ajaxError()
будут выполнены в этот момент. Заметка: Этот обработчик не будет вызван для кросс-доменных скриптов и кросс-доменных JSONP запросов.
Для наблюдения этого метода в действии, установим обработчик и вызовем Ajax load запрос:
1
2
3
|
|
Добавляем обработчик события к document
:
1
2
3
|
|
Теперь, выполняем Ajax запрос при помощи одного из методов jQuery:
1
2
3
|
|
Когда пользователь кликает по кнопке и Ajax запрос завершается ошибкой, потому что запрашиваемый файл отсутсвует, сообщение показывается внутри элемента с классом log
.
Все обработчики ajaxError
будут выполнены, независимо от того как Ajax запрос был завершен. Если Вам нужно различать запросы между собой, то используйте параметры передаваемые в функцию обработчик. Каждый раз когда обработчик ajaxError
выполняется, ему передается объект события (event), объект XMLHttpRequest
(с версии jQuery выше 1.5, the XHR
object) и объект настроек (ajaxSettings) используемый для создания запроса. Когда возникает HTTP ошибка, четвертый аргумнт (thrownError
) передаст текстовое обозначение HTTP статуса, такие как "Not Found" или "Internal Server Error." Например, Вы можете ограничить функцию обратного вызова при обработке события связанного с конкретным URL:
1
2
3
4
5
|
|
Примечание:
- Начиная с версии jQuery 1.9, все обработчики для глобальных Ajax событий, включая добавленные методом
.ajaxComplete()
, должны быть прикреплены к todocument
. - Если
$.ajax()
или$.ajaxSetup()
вызваны с параметромglobal
равнымfalse
, то обработчики.ajaxComplete()
не будут вызваны.