CKTIS / JavaScript
cancelAnimationFrame — отменяне на чакащо извикване
cancelAnimationFrame(handle) премахва чакащо извикване, регистрирано с requestAnimationFrame(). Използвайте върнатия идентификатор в същия контекст; методът не прекъсва код, който вече се изпълнява.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
window.cancelAnimationFrame(handle);cancelAnimationFrame(handle) отменя едно чакащо извикване, регистрирано с requestAnimationFrame(). Подайте върнатия идентификатор handle, а не функцията за извикване, и използвайте същия обект, който предоставя API. Методът връща undefined.
Идентификатор, който вече не е сред чакащите извиквания, не променя нищо. Отмяната не прекъсва извикване, което вече е започнало, и не отменя ефектите му. В цикъл, който планира следващи кадри, запазвайте най-новия идентификатор и отменяйте именно него; по-ранен идентификатор не представлява цялата анимация.
Това е Web API от HTML Living Standard, а не функция на ECMAScript. Поддържа се от актуалните браузърни енджини за Window. Стандартът го предвижда и в поддържани контексти DedicatedWorkerGlobalScope; неподдържан контекст предизвиква NotSupportedError. Версията на Node, използвана в дадено хранилище, не потвърждава наличието на този API.
Примерът отменя първото извикване, след което проверява брояча във второ извикване. Очакваният изход е calls: 0 и result: undefined. Проверката се извършва едва когато браузърът изпълни второто извикване.
Примери
(() => {
let calls = 0;
const handle = window.requestAnimationFrame(() => {
calls += 1;
});
const result = window.cancelAnimationFrame(handle);
window.requestAnimationFrame(() => {
console.log(`calls: ${calls}`);
console.log(`result: ${result}`);
});
})();Резултат
calls: 0 result: undefined
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.