Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes