CKTIS / JavaScript
cancelAnimationFrame — zrušenie čakajúceho callbacku
cancelAnimationFrame(handle) odstráni čakajúci callback zaregistrovaný pomocou requestAnimationFrame(). Použite vrátený identifikátor v rovnakom kontexte; metóda nepreruší už spustený kód.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.cancelAnimationFrame(handle);cancelAnimationFrame(handle) zruší jeden čakajúci callback zaregistrovaný pomocou requestAnimationFrame(). Odovzdajte vrátený identifikátor handle, nie funkciu callbacku, a použite rovnaký objekt, ktorý poskytuje API. Metóda vracia undefined.
Identifikátor, ktorý už nie je medzi čakajúcimi callbackmi, nič nezmení. Zrušenie nepreruší callback, ktorý sa už začal, ani nevráti späť jeho účinky. V cykle, ktorý plánuje ďalšie snímky, ukladajte najnovší identifikátor a zrušte práve ten; skorší identifikátor nepredstavuje celú animáciu.
Ide o Web API z HTML Living Standard, nie o funkciu ECMAScript. Súčasné enginy prehliadačov ju podporujú pre Window. Štandard ju poskytuje aj v podporovaných kontextoch DedicatedWorkerGlobalScope; nepodporovaný kontext vyvolá NotSupportedError. Verzia Node použitá v repozitári nepotvrdzuje dostupnosť tohto API.
Príklad zruší prvý callback a potom skontroluje počítadlo v druhom callbacku. Očakávaný výstup je calls: 0 a result: undefined. Kontrola sa uskutoční až vtedy, keď prehliadač spustí druhý callback.
Príklady
(() => {
let calls = 0;
const handle = window.requestAnimationFrame(() => {
calls += 1;
});
const result = window.cancelAnimationFrame(handle);
window.requestAnimationFrame(() => {
console.log(`calls: ${calls}`);
console.log(`result: ${result}`);
});
})();Výsledok
calls: 0 result: undefined
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.