大网数据广告活动
Web 标准与前端开发

Window:clearTimeout() 方法

· 52CE 我爱测

Window 接口的 **`clearTimeout()`** 方法取消先前通过调用 Window.setTimeout() 建立的超时任务。

HTML DOM

Window 接口的 clearTimeout() 方法取消先前通过调用 Window.setTimeout() 建立的超时任务。

如果参数未标识之前创建的操作,则此方法不执行任何动作。

语法

clearTimeout(timeoutID)

参数

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

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

返回值

无(undefined)。

示例

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

const alarm = {
  remind(aMessage) {
    alert(aMessage);
    this.timeoutID = undefined;
  },

  setup() {
    if (typeof this.timeoutID === "number") {
      this.cancel();
    }

    this.timeoutID = setTimeout(
      (msg) => {
        this.remind(msg);
      },
      1000,
      "醒醒!",
    );
  },

  cancel() {
    clearTimeout(this.timeoutID);
  },
};
window.addEventListener("click", () => alarm.setup());

备注

传入一个无效的 ID 给 clearTimeout() 不会有任何影响;也不会抛出异常。

规范

浏览器兼容性

参见

  • Window.setTimeout()
  • WorkerGlobalScope.clearTimeout()
  • Window.clearInterval()
  • Window.cancelAnimationFrame()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。