CKTIS / JavaScript
Debounce a throttle: řízení volání funkcí
Debounce odloží provedení, dokud série volání neutichne, zatímco throttle během série omezuje četnost provádění. Rozlišujte varianty leading a trailing: určují, zda se zachová první volání, poslední, nebo obě.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle jsou vzory pro řízení volání, nikoli vestavěné funkce ECMAScriptu. Varianta trailing debounce spustí funkci po době klidu wait: každé nové volání zruší předchozí časovač a naplánuje nový. Zachovává nejnovější argumenty a this. Hodí se například ke spuštění hledání po přestávce v psaní; nepřetržitá volání mohou provedení odkládat donekonečna.
Throttle omezuje četnost provádění, i když volání stále přicházejí. Varianta leading v příkladu provede první volání okamžitě a další pak zahazuje, dokud ji časovač znovu neodblokuje. Poslední zahozené volání neprovede. Může sloužit k omezení četnosti zpracování posouvání stránky. Leading znamená provedení na začátku okna, trailing odložené provedení na jeho konci. Implementace mohou nabízet obě varianty; pravidla proto výslovně určete.
Příklad používá syntaxi ECMAScriptu 2015 a funkce setTimeout() a clearTimeout() prohlížeče, které specifikuje HTML, nikoli ECMAScript. Časovače jsou dostupné v kontextech window a worker; podpora v Node 24 nedokazuje podporu rozhraní prohlížeče. V prohlížeči funkce setTimeout() převádí zpoždění na 32bitové celé číslo se znaménkem. Například 2147483648 ms se převede na zápornou hodnotu, se kterou se zachází jako s nulou. Zpoždění nezaručuje přesný čas provedení: jiné úlohy je mohou prodloužit a pro dostatečně vnořené časovače platí minimum 4 ms. Nejde o mechanismus reálného času.
Wrapper vytvořte jednou a opakovaně používejte; jeho vytvářením při každé události ztratíte sdílený stav. Příklad předpokládá platné fn a celočíselnou hodnotu wait v milisekundách, která splňuje 0 <= wait && wait <= 2147483647. Nepředává návratovou hodnotu funkce a nenabízí cancel(), flush() ani maxWait. V produkčním kódu zajistěte zrušení čekající práce při odebrání komponenty. Zrušení časovače nezastaví již zahájený požadavek ani nechrání před zastaralými odpověďmi.
Pří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ýsledek
throttle: A debounce: C
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.