Окно: метод clearTimeout()

Метод clearTimeout() интерфейса Window отменяет таймаут, ранее установленный вызовом Window.setTimeout().

Если переданный параметр не идентифицирует ранее установленное действие, метод ничего не делает.

timeoutID

Идентификатор таймаута, который вы хотите отменить. Этот идентификатор был возвращён соответствующим вызовом setTimeout().

Следует отметить, что пул идентификаторов, используемый setTimeout() и setInterval(), общий, что означает, что вы технически можете использовать clearTimeout() и clearInterval() взаимозаменяемо. Однако, для ясности, этого делать не следует.

None (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,
      "Wake up!",
    );
  },

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

Передача недопустимого идентификатора методу clearTimeout() ничего не делает; исключение не генерируется.

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