stop | onstop event

Fires when the user clicks the Stop button or leaves the document.

Syntax

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

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Standards information

There are no standards that apply here.

Remarks

The onstop event fires after the onbeforeunload event, and before the onunload event.

Initiates any action associated with this event.

To invoke this event, do one of the following:

Click the Stop button.
Leave the document.

The pEvtObj parameter is required for the following interfaces:

Examples

This example uses the onstop event to stop a function from executing in a continuous cycle. The setInterval method is used to execute script every millisecond. If the user clicks the Stop button, the clearInterval method removes the interval and the script is no longer executed.

JavaScript


document.onstop=fnTrapStop;
window.onload=fnInit;
var oInterval;
function fnInit(){
   oInterval=window.setInterval("fnCycle()",1);
}
function fnCycle(){
   // Do something
}
function fnTrapStop(){
   window.clearInterval(oInterval);
}