error event — jQuery | Spec-Zone.ru

Привяжите обработчик событий к событию "error" или сгенерируйте это событие на элементе.

Содержание:

.on( "error" [, eventData ], handler )
- .on( "error" [, eventData ], handler )
.trigger( "error" )
- .trigger( "error" )

.on( "error" [, eventData ], handler )Возвращает: jQuery

Описание: Привязывает обработчик события к событию "error".

версия добавлена: 1.7.on( "error" [, eventData ], handler )
- "error"
  
  Тип: строка
  
  Строка "error".
- eventData
  
  Тип: Любое
  
  Объект, содержащий данные, которые будут переданы обработчику события.
- handler
  
  Тип: Функция( Событие eventObject )
  
  Функция, которая выполняется каждый раз, когда событие срабатывает.

Эта страница описывает событие error. Для метода .error(), удаленного в jQuery 3.0, см. .error().

Событие error отправляется на элементы, такие как изображения, на которые ссылается документ и которые загружаются браузером. Оно вызывается, если элемент не загрузился должным образом.

Например, рассмотрим страницу с простым элементом изображения:

<img alt="Book" id="book">

Обработчик события может быть привязан к изображению:

$( "#book" )
  .on( "error", function() {
    alert( "Handler for `error` called." )
  } )
  .attr( "src", "missing.png" );

Если изображение не может быть загружено (например, потому что его нет по указанному URL), отображается сообщение:

Обработчик `error` вызван.

Обработчик события должен быть привязан до того, как браузер сгенерирует событие error, поэтому в примере атрибут src устанавливается после привязки обработчика. Также событие error может не быть корректно сгенерировано, когда страница загружается локально; error полагается на HTTP-коды состояния и, как правило, не будет срабатывать, если URL использует протокол file:.

Примечание: Обработчик события jQuery error не должен быть привязан к объекту window. Браузер генерирует событие window error при возникновении ошибки скрипта. Однако событие окна error получает другие аргументы и имеет другие требования к возвращаемому значению, чем обычные обработчики событий. Используйте window.onerror вместо этого.

Пример:

Чтобы заменить все отсутствующие изображения другим, можно обновить атрибут src внутри обработчика error. Убедитесь, что изображение для замены существует; в противном случае событие error будет срабатывать бесконечно.

// If missing.png is missing, it is replaced by replacement.png
$( "img" )
  .on( "error", function() {
    $( this ).attr( "src", "replacement.png" );
  } )
  .attr( "src", "missing.png" );

.trigger( "error" )Возвращает: jQuery

Описание: Сгенерировать событие "error" на элементе.

версия добавлена: 1.0.trigger( "error" )
- "error"
  
  Тип: строка
  
  Строка "error".

См. описание для .on( "error", ... ).

событие error

Содержание:

.on( "error" [, eventData ], handler )Возвращает: jQuery

версия добавлена: 1.7.on( "error" [, eventData ], handler )

Пример:

.trigger( "error" )Возвращает: jQuery

версия добавлена: 1.0.trigger( "error" )