CKTIS / JavaScript
Debounce i throttle: ograniczanie wywołań funkcji
Debounce odkłada wykonanie do chwili, gdy seria wywołań ucichnie, a throttle ogranicza częstotliwość wykonywania podczas serii. Rozróżniaj warianty leading i trailing: decydują, czy zachować pierwsze, ostatnie, czy oba wywołania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle to wzorce sterowania wywołaniami, nie wbudowane funkcje ECMAScript. Debounce w wariancie trailing uruchamia funkcję po okresie ciszy wait: każde kolejne wywołanie anuluje poprzedni timer i planuje nowy. Zachowuje ostatnie argumenty oraz this. Nadaje się np. do rozpoczęcia wyszukiwania po przerwie w pisaniu; ciągły napływ wywołań może odkładać wykonanie bez końca.
Throttle ogranicza częstotliwość wykonywania mimo ciągłego napływu wywołań. W przykładzie wariant leading wykonuje pierwsze wywołanie natychmiast, po czym odrzuca następne aż do odblokowania przez timer. Nie wykonuje odrzuconego ostatniego wywołania. Może służyć do ograniczenia częstości obsługi przewijania. Leading oznacza wykonanie na początku okna, trailing — wykonanie odłożone na jego koniec; implementacje mogą oferować oba warianty. Należy jawnie ustalić te zasady.
Przykład wykorzystuje składnię ECMAScript 2015 oraz przeglądarkowe setTimeout() i clearTimeout() określone przez HTML, a nie ECMAScript. Timery są dostępne w kontekstach okna i workerów; obsługa w Node 24 nie dowodzi obsługi API przeglądarki. Przeglądarkowe setTimeout() konwertuje opóźnienie na 32-bitową liczbę całkowitą ze znakiem. Na przykład wartość 2147483648 ms po konwersji staje się ujemna i jest traktowana jak zero. Opóźnienie nie gwarantuje dokładnego czasu wykonania: inne zadania mogą je wydłużyć, a dla odpowiednio zagnieżdżonych timerów obowiązuje minimum 4 ms. Kod nie jest mechanizmem czasu rzeczywistego.
Utwórz wrapper raz i używaj go ponownie; tworzenie go przy każdym zdarzeniu gubi wspólny stan. Przykład zakłada poprawne fn oraz wait podane w milisekundach jako liczbę całkowitą spełniającą warunek 0 <= wait && wait <= 2147483647. Przykład nie przekazuje wyniku funkcji i nie oferuje cancel(), flush() ani maxWait. W kodzie produkcyjnym zaplanuj anulowanie oczekującej pracy przy usuwaniu komponentu. Anulowanie timera nie zatrzyma już rozpoczętego żądania ani nie zabezpieczy przed nieaktualną odpowiedzią.
Przykłady
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);
}Wynik
throttle: A debounce: C
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.