onerror event

Fires when an error occurs during object loading.

Syntax

HTML Attribute <element onerror = "handler(event)">
Event Property object.onerror = handler;
attachEvent Method object.attachEvent("onerror", handler)
addEventListener Method object.addEventListener("error", handler, useCapture)

 

Event information

Synchronous No
Bubbles No
Cancelable Yes

 

Event handler parameters

Standards information

There are no standards that apply here.

Remarks

To suppress the default Windows Internet Explorer error message for the window event, set the IHTMLEventObj::returnValue property of the event object to true or simply return true in Microsoft JScript.

The HTMLDocumentEvents4::onerror event fires for run-time errors, but not for compilation errors. In addition, error dialog boxes raised by script debuggers are not suppressed by returning true. To turn off script debuggers, disable script debugging in Internet Explorer by choosing Internet Options from the Tools menu. Click the Advanced tab and select the appropriate check box(es).

Displays the browser error message when a problem occurs and executes any error handling routine associated with the event.

To invoke this event, do one of the following:

  • Run-time script error, such as an invalid object reference or security violation.
  • Error while downloading an object, such as an image.
  • Windows Internet Explorer 9. An error occurs while fetching media data.

The pEvtObj parameter is required for the following interfaces:

See also

HTMLFrameSiteEvents::onerrorupdate