База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

clearTimeout — отменяне на таймер

clearTimeout(id) отменя чакащо извикване, планирано с setTimeout(). За да го отмените, подайте идентификатора на съответния таймер, а не функцията, подадена като callback. Аргументът не е задължителен: извикването на clearTimeout() без аргумент използва стойността по подразбиране 0 и няма ефект.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

clearTimeout()
clearTimeout(id)

clearTimeout(id) отменя таймера, обозначен със стойността, върната от setTimeout(). Връща undefined. Това е API от стандарта HTML, достъпно в прозорците на браузъра и в worker-и, а не част от самия ECMAScript. Стандартът посочва поддръжка във всички актуални браузърни енджини; наличието на Node 24 не доказва поддръжка на браузърните API.

Запазете идентификатора и отменете таймера в същата глобална среда, в която е създаден. Идентификатор, който липсва от регистъра на таймерите, не променя нищо. Отмяната не прекъсва callback, който вече се изпълнява, и не отменя последиците от него.

clearTimeout() и clearInterval() използват общ регистър, така че технически всяка от тях може да отмени и двата вида таймери. За по-голяма четливост съчетавайте setTimeout() с clearTimeout() и setInterval() с clearInterval().

В примера отмяната се случва синхронно, преди callback-ът да може да се изпълни. Забавяне от 0 не означава незабавно изпълнение, затова единственото изведено съобщение е cancelled.

Примери

(() => {
  const id = setTimeout(() => console.log("unexpected"), 0);
  clearTimeout(id);
  console.log("cancelled");
})();

Резултат

cancelled

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници