WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Debounce und Throttle: Funktionsaufrufe steuern

Debounce verschiebt die Ausführung, bis eine Aufrufserie zur Ruhe kommt; Throttle begrenzt während einer Serie die Ausführungshäufigkeit. Unterscheide Leading- und Trailing-Varianten: Sie legen fest, ob der erste, der letzte oder beide Aufrufe erhalten bleiben.

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

const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);

debounce / throttle sind Muster zur Steuerung von Aufrufen, keine integrierten ECMAScript-Funktionen. Trailing-Debounce führt eine Funktion nach einer Ruhezeit von wait aus: Jeder neue Aufruf bricht den vorherigen Timer ab und plant einen neuen. Dabei bleiben die neuesten Argumente und this erhalten. Das eignet sich etwa, um eine Suche nach einer Tipp-Pause zu starten; fortlaufende Aufrufe können die Ausführung unbegrenzt verschieben.

Throttle begrenzt die Ausführungshäufigkeit, auch wenn fortlaufend Aufrufe eintreffen. Die Leading-Variante im Beispiel führt den ersten Aufruf sofort aus und verwirft danach weitere Aufrufe, bis ein Timer sie wieder freigibt. Der verworfene letzte Aufruf wird nicht ausgeführt. So lässt sich etwa die Häufigkeit der Scroll-Verarbeitung begrenzen. Leading bedeutet Ausführung am Anfang eines Zeitfensters, Trailing eine verzögerte Ausführung an dessen Ende. Implementierungen können beide Varianten anbieten; lege diese Regeln ausdrücklich fest.

Das Beispiel verwendet ECMAScript-2015-Syntax sowie setTimeout() und clearTimeout() des Browsers, die in HTML und nicht in ECMAScript spezifiziert sind. Timer gibt es in Window- und Worker-Kontexten; Unterstützung in Node 24 belegt keine Unterstützung der Browser-API. Im Browser wandelt setTimeout() die Verzögerung in eine vorzeichenbehaftete 32-Bit-Ganzzahl um. Dabei wird beispielsweise 2147483648 ms zu einem negativen Wert, der wie null behandelt wird. Eine Verzögerung garantiert keine exakte Ausführungszeit: Andere Aufgaben können sie verlängern, und für ausreichend tief verschachtelte Timer gilt ein Minimum von 4 ms. Dies ist kein Echtzeitmechanismus.

Erzeuge den Wrapper einmal und verwende ihn wieder; wird er für jedes Ereignis neu erzeugt, geht der gemeinsame Zustand verloren. Das Beispiel setzt ein gültiges fn und ein ganzzahliges wait in Millisekunden voraus, für das 0 <= wait && wait <= 2147483647 gilt. Es gibt den Rückgabewert der Funktion nicht weiter und bietet weder cancel() noch flush() oder maxWait. Sorge im Produktivcode dafür, ausstehende Arbeit beim Entfernen einer Komponente abzubrechen. Das Abbrechen eines Timers stoppt weder eine bereits gestartete Anfrage noch schützt es vor veralteten Antworten.

Beispiele

function debounce(fn, wait) {
  let timer;
  return function (...args) {
    clearTimeout(timer);
    timer = setTimeout(() => {
      timer = undefined;
      fn.apply(this, args);
    }, wait);
  };
}

function throttle(fn, wait) {
  let blocked = false;
  return function (...args) {
    if (blocked) return;
    blocked = true;
    setTimeout(() => { blocked = false; }, wait);
    fn.apply(this, args);
  };
}

const debounced = debounce(value => console.log('debounce:', value), 50);
const throttled = throttle(value => console.log('throttle:', value), 50);

for (const value of ['A', 'B', 'C']) {
  debounced(value);
  throttled(value);
}

Ergebnis

throttle: A
debounce: C

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