CKTIS / JavaScript
Debounce и throttle: управление на извикванията на функции
Debounce отлага изпълнението, докато поредицата от извиквания утихне, а throttle ограничава честотата на изпълнение по време на поредицата. Разграничавайте вариантите leading и trailing: те определят дали се запазва първото извикване, последното или и двете.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle са шаблони за управление на извиквания, а не вградени функции на ECMAScript. Trailing debounce изпълнява функция след период на затишие wait: всяко ново извикване отменя предишния таймер и планира нов. Запазва най-новите аргументи и this. Подходящ е например за стартиране на търсене след пауза при писане; непрекъснатите извиквания могат да отлагат изпълнението безкрайно.
Throttle ограничава честотата на изпълнение дори когато извикванията продължават да постъпват. Вариантът leading в примера изпълнява първото извикване незабавно, след което отхвърля следващите, докато таймер не го отблокира. Той не изпълнява последното отхвърлено извикване. Може да се използва за ограничаване на честотата на обработка на превъртането. Leading означава изпълнение в началото на прозорец, а trailing — отложено изпълнение в края му. Реализациите могат да предлагат и двата варианта, затова определете правилата изрично.
Примерът използва синтаксис на ECMAScript 2015 и браузърните setTimeout() и clearTimeout(), зададени от HTML, а не от ECMAScript. Таймерите са налични в контексти window и worker; поддръжката в Node 24 не доказва поддръжка на браузърния API. В браузъра setTimeout() преобразува забавянето в 32-битово цяло число със знак. Например 2147483648 ms се преобразува в отрицателна стойност, която се третира като нула. Забавянето не гарантира точен момент на изпълнение: други задачи могат да го удължат, а за достатъчно вложени таймери минимумът е 4 ms. Това не е механизъм за работа в реално време.
Създайте wrapper-а веднъж и го използвайте повторно; създаването му при всяко събитие губи споделеното състояние. Примерът предполага валидно fn и целочислена стойност на wait в милисекунди, която удовлетворява условието 0 <= wait && wait <= 2147483647. Той не предава върнатата стойност на функцията и не предлага cancel(), flush() или maxWait. В продукционен код предвидете отмяна на чакащата работа при премахване на компонент. Отмяната на таймер не спира вече започнала заявка и не предпазва от остарели отговори.
Примери
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);
}Резултат
throttle: A debounce: C
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.