CKTIS / JavaScript
IdleDeadline — tijdsbudget van een idle-callback
IdleDeadline is het object dat aan een callback van requestIdleCallback() wordt doorgegeven. Het geeft de geschatte resterende tijd en geeft aan of de callback is uitgevoerd doordat de time-out is verstreken.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });IdleDeadline is een Web API-interface op Window en maakt geen deel uit van ECMAScript. De browser geeft het door aan een callback van requestIdleCallback(); maak het niet aan met new IdleDeadline(). Controleer of de API beschikbaar is; Node 24 bewijst geen ondersteuning in browsers.
IdleDeadline.timeRemaining() geeft de geschatte resterende tijd in milliseconden terug als een niet-negatieve DOMHighResTimeStamp, eventueel met decimalen. Zodra de deadline is bereikt, geeft de methode 0 terug. Controleer de waarde tussen kleine werkeenheden: de deadline onderbreekt geen code die al wordt uitgevoerd.
IdleDeadline.didTimeout is een alleen-lezen booleaanse eigenschap. true betekent dat de aanroep plaatsvond doordat de optie timeout was verstreken; in dat geval geeft timeRemaining() 0 terug. Alleen het opgebruiken van het budget verandert didTimeout niet in true. timeout garandeert geen exact uitvoeringstijdstip.
Het voorbeeld telt getallen in stukken op en plant onafgemaakt werk opnieuw in. Het didTimeout-pad staat één kleine bewerking toe, geen onbegrensde lus. Het werk deelt de hoofdthread op coöperatieve wijze; het wordt niet op een aparte thread uitgevoerd.
Voorbeelden
(() => {
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 });
})();Resultaat
10
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.