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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.