CKTIS / JavaScript
cancelAnimationFrame — annullare una callback in attesa
cancelAnimationFrame(handle) rimuove una callback in attesa registrata con requestAnimationFrame(). Usa l’identificatore restituito nello stesso contesto; il metodo non interrompe il codice già in esecuzione.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
window.cancelAnimationFrame(handle);cancelAnimationFrame(handle) annulla una singola callback in attesa registrata con requestAnimationFrame(). Passa l’identificatore restituito handle, non la funzione di callback, e usa lo stesso oggetto che fornisce l’API. Il metodo restituisce undefined.
Un identificatore che non è più tra le callback in attesa non modifica nulla. L’annullamento non interrompe una callback già avviata e non ne annulla gli effetti. In un ciclo che pianifica i frame successivi, salva l’identificatore più recente e annulla quello; un identificatore precedente non rappresenta l’intera animazione.
Questa è una Web API dell’HTML Living Standard, non una funzione ECMAScript. È supportata dai motori dei browser attuali per Window. Lo standard la prevede anche nei contesti DedicatedWorkerGlobalScope supportati; un contesto non supportato genera NotSupportedError. La versione di Node usata in un repository non dimostra la disponibilità di questa API.
L’esempio annulla la prima callback e poi controlla il contatore in una seconda callback. L’output atteso è calls: 0 e result: undefined. Il controllo avviene solo quando il browser esegue la seconda callback.
Esempi
(() => {
let calls = 0;
const handle = window.requestAnimationFrame(() => {
calls += 1;
});
const result = window.cancelAnimationFrame(handle);
window.requestAnimationFrame(() => {
console.log(`calls: ${calls}`);
console.log(`result: ${result}`);
});
})();Risultato
calls: 0 result: undefined
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.