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

CKTIS / JavaScript

requestIdleCallback — trabajo durante los periodos de inactividad

requestIdleCallback programa trabajo no urgente durante los periodos de inactividad del navegador. Su callback recibe un presupuesto de tiempo estimado, pero debe dividir el trabajo y ceder el control por sí mismo.

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

const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);

window.requestIdleCallback(callback, options) programa una sola vez trabajo no urgente en el bucle de eventos de la página, no en un hilo separado. El identificador devuelto permite cancelar una llamada pendiente mediante window.cancelIdleCallback(handle).

El callback recibe un IdleDeadline: timeRemaining() indica los milisegundos restantes estimados, nunca por debajo de cero. Divide el trabajo en unidades pequeñas y vuelve a programar lo que quede; el navegador no interrumpe automáticamente una operación larga.

Sin timeout, la espera puede ser ilimitada. Un timeout positivo, en milisegundos, pone una tarea en cola una vez transcurrido ese intervalo, pero no garantiza una hora exacta de ejecución. didTimeout indica que se ejecutó por esta vía; en ese caso, timeRemaining() vale cero. El ejemplo procesa solo un elemento por llamada en esa situación.

Es una API web de Window, no una característica de ECMAScript; disponer de Node 24 no demuestra que sea compatible. Comprueba su disponibilidad en el navegador de destino. La fuente es un borrador del W3C, no una tabla de compatibilidad de navegadores.

Ejemplos

(() => {
  if (typeof window.requestIdleCallback !== "function") {
    console.log("requestIdleCallback unavailable");
    return;
  }

  const items = [1, 2, 3, 4];
  let index = 0;
  let sum = 0;

  function work(deadline) {
    let processed = 0;
    while (index < items.length &&
           (deadline.timeRemaining() > 0 ||
            (deadline.didTimeout && processed === 0))) {
      sum += items[index++];
      processed++;
    }
    if (index < items.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(sum);
    }
  }

  window.requestIdleCallback(work, { timeout: 1000 });
})();

Resultado

10

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