WindowOrWorkerGlobalScope.clearTimeout()
clearTimeout()
метод WindowOrWorkerGlobalScope
отменяет таймаут, ранее установленный вызовом setTimeout()
.
Синтаксис
scope.clearTimeout(timeoutID)
Параметры
timeoutID
-
Идентификатор таймаута, который вы хотите отменить. Этот идентификатор был возвращён соответствующим вызовом
setTimeout()
.
It's worth noting that the pool of IDs used by setTimeout()
and setInterval()
are shared, which means you can technically use clearTimeout()
and clearInterval()
(en-US) interchangeably. However, for clarity, you should avoid doing so.
Пример использования:
Запустите приведённый ниже скрипт в контакте веб-страницы и кликните один раз. Вы увидите всплывающее сообщение через 1 секунду. Если вы щёлкните страницу несколько раз за одну секунду, предупреждение появится только один раз.
var alarm = {
remind: function(aMessage) {
alert(aMessage);
this.timeoutID = undefined;
},
setup: function() {
if (typeof this.timeoutID === 'number') {
this.cancel();
}
this.timeoutID = window.setTimeout(function(msg) {
this.remind(msg);
}.bind(this), 1000, 'Wake up!');
},
cancel: function() {
window.clearTimeout(this.timeoutID);
}
};
window.onclick = function() { alarm.setup(); };
Примечания
Передача недействительного ID clearTimeout()
ни к чему не приведёт. Исключение не создается.
Спецификация
Specification | Status | Comment |
---|---|---|
HTML Living Standard Определение 'WindowOrWorkerGlobalScope.clearTimeout()' в этой спецификации. |
Живой стандарт | Method moved to the WindowOrWorkerGlobalScope mixin in the latest spec. |
HTML Living Standard Определение 'clearTimeout()' в этой спецификации. |
Живой стандарт |
Совместимость с браузером
BCD tables only load in the browser