CKTIS / JavaScript
Debounce a throttle: riadenie volaní funkcií
Debounce odloží vykonanie, kým séria volaní neutíchne, zatiaľ čo throttle počas série obmedzuje frekvenciu vykonávania. Rozlišujte varianty leading a trailing: určujú, či sa zachová prvé volanie, posledné alebo obe.
Verzia: 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 sú vzory na riadenie volaní, nie vstavané funkcie ECMAScriptu. Varianta trailing debounce spustí funkciu po období pokoja wait: každé nové volanie zruší predchádzajúci časovač a naplánuje nový. Zachováva najnovšie argumenty a this. Hodí sa napríklad na spustenie vyhľadávania po prestávke v písaní; nepretržité volania môžu vykonanie odkladať donekonečna.
Throttle obmedzuje frekvenciu vykonávania, aj keď volania stále prichádzajú. Varianta leading v príklade vykoná prvé volanie okamžite a ďalšie potom zahadzuje, kým ju časovač znova neodblokuje. Posledné zahodené volanie nevykoná. Môže poslúžiť na obmedzenie frekvencie spracovania posúvania stránky. Leading znamená vykonanie na začiatku okna, trailing odložené vykonanie na jeho konci. Implementácie môžu ponúkať oba varianty; tieto pravidlá preto výslovne určite.
Príklad používa syntax ECMAScriptu 2015 a funkcie setTimeout() a clearTimeout() prehliadača, ktoré špecifikuje HTML, nie ECMAScript. Časovače sú dostupné v kontextoch window a worker; podpora v Node 24 nedokazuje podporu rozhrania prehliadača. V prehliadači funkcia setTimeout() prevádza oneskorenie na 32-bitové celé číslo so znamienkom. Napríklad 2147483648 ms sa prevedie na zápornú hodnotu, s ktorou sa zaobchádza ako s nulou. Oneskorenie nezaručuje presný čas vykonania: iné úlohy ho môžu predĺžiť a pre dostatočne vnorené časovače platí minimum 4 ms. Nejde o mechanizmus reálneho času.
Wrapper vytvorte raz a opakovane používajte; jeho vytváraním pri každej udalosti stratíte zdieľaný stav. Príklad predpokladá platné fn a celočíselnú hodnotu wait v milisekundách, ktorá spĺňa 0 <= wait && wait <= 2147483647. Neodovzdáva návratovú hodnotu funkcie a neponúka cancel(), flush() ani maxWait. V produkčnom kóde zabezpečte zrušenie čakajúcej práce pri odstránení komponentu. Zrušenie časovača nezastaví už spustenú požiadavku ani nechráni pred zastaranými odpoveďami.
Príklady
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);
}Výsledok
throttle: A debounce: C
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.