CKTIS / JavaScript
cancelIdleCallback(): cancelar una devolución de llamada pendiente
cancelIdleCallback(handle) cancela una devolución de llamada pendiente programada por requestIdleCallback(). Necesita el identificador de la solicitud, no la propia función de devolución de llamada.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
window.cancelIdleCallback(handle)window.cancelIdleCallback(handle) recibe el identificador numérico que devuelve requestIdleCallback() en la misma ventana. El método elimina la devolución de llamada pendiente, incluso si ya está lista para ejecutarse. Devuelve undefined.
Si el identificador no corresponde a ninguna solicitud pendiente, el método no hace nada. No puede interrumpir una devolución de llamada que ya ha empezado ni deshacer sus efectos.
Es una API Web de Window, no una función definida por ECMAScript. Comprueba que ambos métodos estén disponibles; que Node 24 esté en un repositorio no demuestra que haya compatibilidad con los navegadores.
El ejemplo cancela la solicitud justo después de programarla, antes de ceder el control al navegador. Guarda el identificador para poder cancelar el trabajo que ya no sea necesario.
Ejemplos
(() => {
if (typeof window === "undefined" ||
typeof window.requestIdleCallback !== "function" ||
typeof window.cancelIdleCallback !== "function") {
console.log("Idle callbacks unavailable");
return;
}
const handle = window.requestIdleCallback(() => {
console.log("Unexpected callback");
});
window.cancelIdleCallback(handle);
console.log("Cancellation requested");
})();Resultado
Cancellation requested
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.