clearTimeout()

WindowOrWorkerGlobalScope 内置的 clearTimeout() 方法取消了先前通过调用setTimeout()建立的定时器。

语法

scope.clearTimeout(timeoutID)

Parameters

timeoutID

您要取消定时器的标识符。该 ID 由相应的setTimeout()调用返回。

值得注意的是，setTimeout() 和 setInterval() 使用共享的 ID 池，意味着在技术上可以混用 clearTimeout() 和 clearInterval()。但是，为了清楚起见，你应该避免这样做。

示例

在一个网页中运行如下脚本，并且点击一次页面。一秒钟后你会看见弹出一条信息。如果你在一秒内不停点击页面，弹出框将不再出现。

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() };

注意

传入一个错误的 ID 给 clearTimeout()不会有任何影响；也不会抛出异常。

规范

Specification
HTML Standard
# dom-cleartimeout-dev

浏览器兼容

BCD tables only load in the browser

更多