CKTIS / JavaScript
`throttle` — ograniczanie częstotliwości wywołań
`throttle` ogranicza częstotliwość wykonywania funkcji nawet wtedy, gdy wywołania napływają bez przerwy. Przydaje się na przykład podczas przewijania.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.throttle to umowna nazwa funkcji pomocniczej, a nie wbudowana funkcja ECMAScript ani standardowe API przeglądarki. Zwraca funkcję opakowującą, która ogranicza częstotliwość uruchamiania funkcji fn. Można jej użyć na przykład do rzadszego odświeżania interfejsu podczas przewijania. Utwórz funkcję opakowującą raz i używaj jej ponownie: każda instancja osobno zapamiętuje chwilę ostatniego uruchomienia.
W przykładzie pierwsze wywołanie uruchamia fn od razu (leading edge). Następne może uruchomić fn, gdy od poprzedniego uruchomienia upłynie co najmniej intervalMs. Wcześniejsze wywołania zwracają undefined, nie przedłużają odstępu i nie trafiają do kolejki. Uruchomienie przekazuje this i argumenty, a wynik lub wyjątek pochodzi bezpośrednio z fn.
Inne warianty mogą wykonać ostatnie oczekujące wywołanie na końcu odstępu (trailing edge). Tutaj samo upłynięcie czasu niczego nie uruchamia. Typowy debounce działający na końcu serii czeka na przerwę w wywołaniach; throttle może uruchamiać funkcję także bez takiej przerwy.
Podaj dodatni, skończony odstęp i zegar now zwracający skończone, niemalejące wartości w milisekundach. Przykład używa symulowanego zegara; w przeglądarce można przekazać () => performance.now(). To API platformy webowej, więc sprawdź dostępność w docelowym środowisku. Jeśli inny wariant używa setTimeout(), jego funkcja zwrotna może wykonać się później, niż zaplanowano.
Przykłady
{
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");
}Wynik
Update: A Update: C
A uruchamia się przy 0 ms, B zostaje pominięte przy 40 ms, C uruchamia się dokładnie na granicy 100 ms, a D zostaje pominięte przy 140 ms i nie wykona się później.
Powiązane lekcje
- JavaScript · Lekcja 21 · Podstawowy · Wersja: 4