Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IdleDeadline — časový rozpočet callbacku počas nečinnosti

IdleDeadline je objekt odovzdaný callbacku requestIdleCallback(). Sprístupňuje odhad zostávajúceho času a informuje, či sa callback spustil po vypršaní časového limitu.

Verzia: 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 je rozhranie Web API dostupné na Window, nie súčasť ECMAScriptu. Prehliadač ho poskytuje callbacku requestIdleCallback(); nevytvárajte ho pomocou new IdleDeadline(). Overte dostupnosť API; Node 24 nedokazuje podporu v prehliadači.

IdleDeadline.timeRemaining() vracia odhad zostávajúceho času v milisekundách ako nezáporný DOMHighResTimeStamp, prípadne s desatinnou časťou. Po dosiahnutí termínu vracia 0. Kontrolujte ho medzi malými úsekmi práce: termín nepreruší práve vykonávaný kód.

IdleDeadline.didTimeout je boolovská vlastnosť iba na čítanie. Hodnota true znamená, že volanie nastalo po vypršaní možnosti timeout; v takom prípade timeRemaining() vracia 0. Samotné vyčerpanie rozpočtu nenastaví didTimeout na true. timeout nezaručuje presný čas vykonania.

Príklad sčítava čísla po častiach a nedokončenú prácu naplánuje znova. Vetva didTimeout povoľuje jednu malú operáciu, nie neobmedzenú slučku. Práca sa kooperatívne delí o hlavné vlákno; nevykonáva sa v samostatnom vlákne.

Príklady

(() => {
  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 });
})();

Výsledok

10

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje