JavaScript: The Definitive Guide, Fourth Edition

Name

Image.onerror — the handler invoked when an error occurs during image loading

Availability

JavaScript 1.1

Synopsis

<img ... onerror="handler" ... >
image.onerror

Description

The onerror property of an Image object specifies an event handler function that is invoked when an error occurs during the loading of an image.

The initial value of this property is a function that contains the JavaScript statements specified by the onerror attribute of the <img> tag that defined the Image object. When an event handler function is defined by an HTML attribute, it is executed in the scope of element rather than in the scope of the containing window.

In the Netscape 4 event model, the onerror handler function is passed an Event object as an argument. In the IE event model, no argument is passed, but the applicable Event object is available as the event property of the Window object that contains the element.