CKTIS / JavaScript
IdleDeadline — časovni proračun klica med nedejavnostjo
IdleDeadline je objekt, posredovan funkciji povratnega klica requestIdleCallback(). Poda oceno preostalega časa in pove, ali se je klic izvedel zaradi poteka časovne omejitve.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });IdleDeadline je vmesnik Web API, izpostavljen na Window, in ni del ECMAScripta. Brskalnik ga posreduje funkciji povratnega klica requestIdleCallback(); ne ustvarite ga z new IdleDeadline(). Preverite, ali je API na voljo; Node 24 ne dokazuje podpore v brskalniku.
IdleDeadline.timeRemaining() vrne oceno preostalega časa v milisekundah kot nenegativen DOMHighResTimeStamp, ki je lahko tudi decimalen. Ko je rok dosežen, vrne 0. Vrednost preverjajte med majhnimi enotami dela: rok ne prekine kode, ki se že izvaja.
IdleDeadline.didTimeout je logična lastnost, namenjena samo branju. Vrednost true pomeni, da je do klica prišlo zaradi poteka možnosti timeout; v tem primeru timeRemaining() vrne 0. Zgolj izčrpanje proračuna ne spremeni didTimeout v true. timeout ne zagotavlja natančnega časa izvajanja.
Primer sešteva števila po delih in znova razporedi nedokončano delo. Pot didTimeout dovoljuje eno majhno operacijo, ne neomejene zanke. Delo si na sodelovalen način deli glavno nit; ne izvaja se v ločeni niti.
Primeri
(() => {
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 });
})();Rezultat
10
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.