KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

requestIdleCallback — werk tijdens inactieve perioden

requestIdleCallback plant niet-dringend werk tijdens inactieve perioden van de browser. De callback krijgt een geschat tijdsbudget, maar moet het werk zelf opdelen en de controle overdragen.

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

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

window.requestIdleCallback(callback, options) plant niet-dringend werk eenmalig in de eventloop van de pagina, niet in een aparte thread. Met de geretourneerde handle kan een wachtende aanroep worden geannuleerd via window.cancelIdleCallback(handle).

De callback ontvangt een IdleDeadline: timeRemaining() geeft de geschatte resterende milliseconden aan, nooit minder dan nul. Deel het werk op in kleine eenheden en plan het restant opnieuw in; de browser onderbreekt een langdurige bewerking niet automatisch.

Zonder timeout kan het wachten onbeperkt duren. Een positieve timeout in milliseconden zet na dat interval een taak in de wachtrij, maar garandeert geen exact uitvoertijdstip. didTimeout geeft aan dat de uitvoering via deze route plaatsvond; dan is timeRemaining() nul. In dat geval verwerkt het voorbeeld per aanroep slechts één item.

Dit is een Web-API van Window, geen ECMAScript-functie; de aanwezigheid van Node 24 bewijst niet dat de API wordt ondersteund. Controleer de beschikbaarheid in de doelbrowser. De bron is een W3C-concept, geen compatibiliteitstabel voor browsers.

Voorbeelden

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

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.

Bronnen