CKTIS / JavaScript
`throttle` — begrenzen, wie oft eine Funktion läuft
`throttle` begrenzt, wie oft eine Funktion ausgeführt wird, auch wenn ständig Aufrufe eintreffen. Das spart zum Beispiel Arbeit beim Scrollen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.throttle ist ein gebräuchlicher Name für eine Hilfsfunktion, keine eingebaute ECMAScript-Funktion und keine Standard-Browser-API. Sie gibt eine Wrapper-Funktion zurück, die begrenzt, wie oft fn startet. So lässt sich etwa die Oberfläche beim Scrollen seltener aktualisieren. Erstelle den Wrapper einmal und verwende ihn erneut: Jeder Wrapper merkt sich seine eigene letzte Startzeit.
Im Beispiel führt der erste Aufruf fn sofort aus (leading edge). Ein weiterer Aufruf kann fn ausführen, sobald seit dem vorherigen Start mindestens intervalMs vergangen sind. Zu frühe Aufrufe geben undefined zurück, verlängern das Intervall nicht und werden nicht vorgemerkt. Bei der Ausführung werden this und die Argumente weitergereicht; das Ergebnis oder die Ausnahme von fn wird unverändert weitergegeben.
Andere Varianten können den letzten vorgemerkten Aufruf am Ende des Intervalls ausführen (trailing edge). Hier löst der bloße Zeitablauf nichts aus. Ein typisches debounce mit Ausführung am Ende wartet auf eine Aufrufpause; throttle kann die Funktion auch ohne Pause weiter ausführen.
Übergib ein positives, endliches Intervall und eine Uhrfunktion now, die endliche, nicht abnehmende Werte in Millisekunden liefert. Das Beispiel nutzt eine simulierte Uhr; im Browser kannst du () => performance.now() übergeben. Das ist eine API der Webplattform; prüfe ihre Verfügbarkeit in der Zielumgebung. Nutzt eine andere Variante setTimeout(), kann deren Callback später als geplant laufen.
Beispiele
{
function throttle(fn, intervalMs, now) {
let lastRun;
return function (...args) {
const time = now();
if (lastRun !== undefined && time - lastRun < intervalMs) {
return undefined;
}
lastRun = time;
return Reflect.apply(fn, this, args);
};
}
let time = 0;
const panel = {
prefix: "Update",
update: throttle(function (label) {
console.log(`${this.prefix}: ${label}`);
}, 100, () => time),
};
panel.update("A");
time = 40;
panel.update("B");
time = 100;
panel.update("C");
time = 140;
panel.update("D");
}Ergebnis
Update: A Update: C
A läuft bei 0 ms, B wird bei 40 ms übersprungen, C läuft genau an der Grenze von 100 ms und D wird bei 140 ms übersprungen und nicht nachgeholt.
Zugehörige Lektionen
- JavaScript · Lektion 21 · Grundlagen · Version: 4