.error( handler(объектСобытия) )
Добавлена в версию: 1.0
handler(объектСобытия)
Функция
Функция выполняется каждый раз, когда вызывается событие.
.error( [ данныеСобытия ], обработчик(объектСобытия)
Добавлена в версию: 1.4.3
Карта данных, которая будет передана в обработчик событий.
обработчик(объектСобытия)
Функция
Функция для выполнения каждый раз, когда событие вызвано.
Этот метод является сокращением для .bind('error', handler).
Событие error
направлено на элементы, такие как изображения, на которые есть ссылки в документе, и загружаются в браузере.
Оно вызывается, если элемент не был загружен правильно. Обработчик события может быть связан с изображением:
$('#book').error(function() {
alert('Handler for .error() called.')
});
Для примера, рассмотрим страницу с обычным изображением:
<img src="missing.png" alt="Book" id="book" />
Если изображение не может быть загруженно (например,
потому что оно не присутствует в поставляемом URL), будет показанно предупреждение:
Handler for .error() called.
Это событие не может быть выполненно правильно, когда страница выполняется локально.
Поскольку error зависит от нормального состояния кода HTTP, оно обычно не срабатывает, если URL использует протокол file:.
Примечание: Обработчик
события jQuery не должен быть приложен к объекту window.
Браузер запустит событие ошибки на окно, когда произойдет ошибка
сценария.
Впрочем, событие ошибки окна получает различные аргументы и имеет
различные возвращаемые значения, чем обычные обработчики событий.
Примеры
Пример 1
Для того, чтобы сохранять на сервере лог ошибок JavaScript, следует сделать так:
$(window).error(function(msg, url, line){
jQuery.post("js_error_log.php", { msg: msg, url: url, line: line });
});
Пример 2
Для скрытия ошибок JavaScript от пользователя Вы можете попробовать сделать так:
$(window).error(function(){
return true;
});
Пример 3
Для скрытия пиктограмм «Поврежденное изображение» в IE можно попробовать сделать следующее:
$("img").error(function(){
$(this).hide();
});
|