onunload event

Article
2017-05-02

Fires immediately before the object is unloaded.

Syntax

HTML Attribute	<element onunload = "handler(event)">
Event Property	object.onunload = handler;
attachEvent Method	object.attachEvent("onunload", handler)

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]
Type: IHTMLEventObj

Standards information

HTML 4.01 Specification, Section 18.2.3

Remarks

If you call window.IHTMLWindow2::open from this event, the Pop-up Blocker feature in Microsoft Internet Explorer 6 prevents the pop-up window from appearing.

Removes the object or document from the browser window.

To invoke this event, do one of the following:

Close the current window.
Navigate to another location by entering a new address or selecting a Favorite.
Click the Back, Forward, Refresh, or Home button.
Click an anchor that refers the browser to another document.
Invoke the anchor.IHTMLElement::click method.
Invoke the document.IHTMLDocument2::write method.
Invoke the document.IHTMLDocument2::open method.
Invoke the document.IHTMLDocument2::close method.
Invoke the window.IHTMLWindow2::close method.
Invoke the window.IHTMLWindow2::open method, providing the possible value _self for the window name.
Invoke the window.IHTMLWindow2::navigate or IShellUIHelper::NavigateAndFind method.
Invoke the location.IHTMLLocation::replace method.
Invoke the location.IHTMLLocation::reload method.
Specify a new value for the location.IHTMLLocation::href property.
Submit a form to the address specified in the IHTMLFormElement4::action attribute via the INPUT type=submit control, or invoke the form.IHTMLFormElement::submit method.

For security reasons, the HTMLWindowEvents::onunload event does not open modeless dialog boxes, such as those created with the IHTMLWindow2::alert method or the IHTMLWindow3::showModelessDialog method. This changes affects webpages displayed in IE9 Standards mode or later document modes.

The pEvtObj parameter is required for the following interfaces:

Share via