.error()

Categories: Events > Browser Events

.error( handler(eventObject) ) 返回： jQuery

描述： 绑定一个事件处理器到“错误”JavaScript事件上。

version added: 1.0.error( handler(eventObject) )

handler(eventObject)每当事件触发时执行的函数。
version added: 1.4.3.error( [ eventData ], handler(eventObject) )

eventData将要传递给事件处理函数的数据映射。

handler(eventObject)每当事件触发时执行的函数。

这个方法是 .bind('error', handler) 的快捷方式。

error事件被发送到元素，比如一张图片，通过文件引用，由浏览器加载。如果没有正确装入，这个事件就会被调用。

例子，考虑一个简单的图像页面：

<img src="missing.png" alt="Book" id="book" />

事件处理器可以绑定到图像上：

$('#book').error(function() {
  alert('Handler for .error() called.')
});

如果图像无法加载（例如，因为不存在目前所提供的URL），警告显示：

Handler for .error() called.

当页面保存到本地的时候此事件可能无法正确触发。由于error依赖于正常的HTTP状态码，如果URL使用file:协议，它通常不会被触发。

注意：一个jQuery的error事件处理器不应该附加到window对象上。当一个脚本错误的时候，浏览器就会触发窗口的错误事件。无论如何，窗口错误事件接收不同的参数，并有不同的返回值比传统的事件处理器的要求。

$(window).error(function(){
  return true;
});

$("img").error(function(){
  $(this).hide();
});