WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IdleDeadline — Zeitbudget eines Idle-Callbacks

IdleDeadline ist das Objekt, das an einen requestIdleCallback()-Callback übergeben wird. Es stellt die geschätzte verbleibende Zeit bereit und zeigt an, ob der Callback wegen des Ablaufs seines Timeouts ausgeführt wurde.

Version: 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 ist eine Web-API-Schnittstelle auf Window und kein Bestandteil von ECMAScript. Der Browser übergibt sie an einen requestIdleCallback()-Callback; erstelle sie nicht mit new IdleDeadline(). Prüfe die Verfügbarkeit der API per Feature Detection; Node 24 belegt keine Browserunterstützung.

IdleDeadline.timeRemaining() gibt die geschätzte verbleibende Zeit in Millisekunden als nicht negativen DOMHighResTimeStamp zurück, möglicherweise mit Nachkommastellen. Ist die Deadline erreicht, wird 0 zurückgegeben. Prüfe den Wert zwischen kleinen Arbeitsschritten: Die Deadline unterbricht keinen bereits ausgeführten Code.

IdleDeadline.didTimeout ist ein boolescher, schreibgeschützter Wert. true bedeutet, dass der Aufruf wegen des Ablaufs der Option timeout erfolgt ist; in diesem Fall gibt timeRemaining() 0 zurück. Allein das Ausschöpfen des Zeitbudgets setzt didTimeout nicht auf true. timeout garantiert keinen genauen Ausführungszeitpunkt.

Das Beispiel summiert Zahlen in Abschnitten und plant nicht abgeschlossene Arbeit erneut ein. Der didTimeout-Pfad erlaubt eine kleine Operation, keine unbegrenzte Schleife. Dabei wird der Hauptthread kooperativ mitgenutzt; die Arbeit läuft nicht in einem separaten Thread.

Beispiele

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

Ergebnis

10

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen