Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

IdleDeadline — časový rozpočet callbacku v době nečinnosti

IdleDeadline je objekt předaný callbacku requestIdleCallback(). Zpřístupňuje odhad zbývajícího času a udává, zda se callback spustil kvůli vypršení časového limitu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });

IdleDeadline je rozhraní Web API dostupné na Window, nikoli součást ECMAScriptu. Prohlížeč jej předává callbacku requestIdleCallback(); nevytvářejte ho pomocí new IdleDeadline(). Ověřte dostupnost API; Node 24 nedokládá podporu v prohlížeči.

IdleDeadline.timeRemaining() vrací odhad zbývajícího času v milisekundách jako nezáporný DOMHighResTimeStamp, případně s desetinnou částí. Po dosažení termínu vrací 0. Kontrolujte hodnotu mezi malými úseky práce: termín nepřeruší právě vykonávaný kód.

IdleDeadline.didTimeout je booleovská vlastnost pouze pro čtení. Hodnota true znamená, že k volání došlo kvůli vypršení možnosti timeout; v takovém případě timeRemaining() vrací 0. Samotné vyčerpání rozpočtu nezmění didTimeout na true. timeout nezaručuje přesný čas spuštění.

Příklad sčítá čísla po částech a nedokončenou práci naplánuje znovu. Větev didTimeout povoluje jednu malou operaci, nikoli neomezenou smyčku. Práce se kooperativně dělí o hlavní vlákno; neběží v samostatném vlákně.

Pří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ýsledek

10

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje