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

CKTIS / JavaScript

requestIdleCallback — práce během nečinnosti

requestIdleCallback plánuje méně naléhavou práci na dobu, kdy je prohlížeč nečinný. Callback dostane odhadovaný časový rozpočet, ale práci musí sám rozdělit a předat řízení dál.

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

const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);

window.requestIdleCallback(callback, options) naplánuje jednorázově méně naléhavou práci ve smyčce událostí stránky, nikoli v samostatném vlákně. Vrácený identifikátor umožňuje zrušit čekající volání pomocí window.cancelIdleCallback(handle).

Callback obdrží IdleDeadline: timeRemaining() uvádí odhad zbývajícího času v milisekundách, nikdy méně než nula. Rozdělte práci na malé části a zbytek naplánujte znovu; prohlížeč dlouhou operaci automaticky nepřeruší.

Bez timeout může čekání trvat neomezeně dlouho. Kladný timeout v milisekundách zařadí úlohu po uplynutí tohoto intervalu do fronty, ale nezaručuje přesný čas provedení. didTimeout označuje spuštění touto cestou; v takovém případě je timeRemaining() nula. Příklad tehdy zpracuje při jednom volání pouze jednu položku.

Jde o Web API rozhraní Window, nikoli o funkci ECMAScriptu; přítomnost Node 24 nedokazuje podporu. Ověřte dostupnost v cílovém prohlížeči. Zdrojem je návrh W3C, nikoli tabulka kompatibility prohlížečů.

Příklady

(() => {
  if (typeof window.requestIdleCallback !== "function") {
    console.log("requestIdleCallback unavailable");
    return;
  }

  const items = [1, 2, 3, 4];
  let index = 0;
  let sum = 0;

  function work(deadline) {
    let processed = 0;
    while (index < items.length &&
           (deadline.timeRemaining() > 0 ||
            (deadline.didTimeout && processed === 0))) {
      sum += items[index++];
      processed++;
    }
    if (index < items.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(sum);
    }
  }

  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