CKTIS / JavaScript
IdleDeadline — presupuesto de tiempo de una llamada en inactividad
IdleDeadline es el objeto que se pasa a una función de retorno de llamada de requestIdleCallback(). Expone el tiempo restante estimado e indica si la llamada se ejecutó porque venció su tiempo de espera.
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.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });IdleDeadline es una interfaz de la API Web disponible en Window, no forma parte de ECMAScript. El navegador la proporciona a una función de retorno de llamada de requestIdleCallback(); no la crees con new IdleDeadline(). Comprueba si la API está disponible; Node 24 no demuestra que sea compatible con los navegadores.
IdleDeadline.timeRemaining() devuelve el tiempo restante estimado en milisegundos como un DOMHighResTimeStamp no negativo, posiblemente fraccionario. Cuando se alcanza el plazo, devuelve 0. Comprueba el valor entre pequeñas unidades de trabajo: el plazo no interrumpe el código que ya se está ejecutando.
IdleDeadline.didTimeout es una propiedad booleana de solo lectura. true significa que la llamada se produjo porque venció la opción timeout; en ese caso, timeRemaining() devuelve 0. Agotar el presupuesto por sí solo no cambia didTimeout a true. timeout no garantiza un momento exacto de ejecución.
El ejemplo suma números por partes y vuelve a programar el trabajo pendiente. La ruta didTimeout permite una operación pequeña, no un bucle ilimitado. El trabajo comparte el hilo principal de forma cooperativa; no se ejecuta en un hilo aparte.
Ejemplos
(() => {
if (typeof window.requestIdleCallback !== "function") {
console.log("requestIdleCallback unavailable");
return;
}
const values = [1, 2, 3, 4];
let index = 0;
let total = 0;
function work(deadline) {
let processed = 0;
while (
index < values.length &&
(deadline.timeRemaining() > 1 ||
(deadline.didTimeout && processed === 0))
) {
total += values[index++];
processed++;
}
if (index < values.length) {
window.requestIdleCallback(work, { timeout: 1000 });
} else {
console.log(total);
}
}
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.