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.