Clears the delay set by WindowTimers.setTimeout().

Syntax

window.clearTimeout(timeoutID)

Example

Run the script below in the context of a web page and click on the page once. You'll see a message popping up in a second. If you keep clicking on the page once in a second, the alert never appears.

var alarm = {
  remind: function(aMessage) {
    alert(aMessage);
    delete this.timeoutID;
  },

  setup: function() {
    this.cancel();
    var self = this;
    this.timeoutID = window.setTimeout(function(msg) {self.remind(msg);}, 1000, "Wake up!");
  },

  cancel: function() {
    if(typeof this.timeoutID == "number") {
      window.clearTimeout(this.timeoutID);
      delete this.timeoutID;
    }
  }
};
window.onclick = function() { alarm.setup() };

Notes

Passing an invalid ID to clearTimeout does not have any effect (and doesn't throw an exception).

Specification

Specified in HTML5.

See also

Document Tags and Contributors

Tags: 
Last updated by: hweeks,
Hide Sidebar