CKTIS / JavaScript
Debounce i throttle: upravljanje pozivima funkcija
Debounce odgađa izvršavanje dok se niz poziva ne smiri, a throttle ograničava učestalost izvršavanja tijekom niza. Razlikujte varijante leading i trailing: one određuju zadržava li se prvi poziv, posljednji ili oba.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle obrasci su za upravljanje pozivima, a ne ugrađene funkcije ECMAScripta. Trailing debounce izvršava funkciju nakon razdoblja mirovanja wait: svaki novi poziv otkazuje prethodni mjerač vremena i zakazuje novi. Zadržava najnovije argumente i this. Prikladan je, primjerice, za pokretanje pretraživanja nakon stanke u tipkanju; neprekidni pozivi mogu odgađati izvršavanje unedogled.
Throttle ograničava učestalost izvršavanja čak i dok pozivi stalno pristižu. Varijanta leading u primjeru odmah izvršava prvi poziv, a zatim odbacuje sljedeće dok je mjerač vremena ponovno ne odblokira. Ne izvršava posljednji odbačeni poziv. Može poslužiti za ograničavanje učestalosti obrade pomicanja. Leading znači izvršavanje na početku vremenskog prozora, a trailing odgođeno izvršavanje na njegovu kraju. Implementacije mogu nuditi obje varijante, pa ta pravila izričito odredite.
Primjer koristi sintaksu ECMAScripta 2015 te setTimeout() i clearTimeout() preglednika, koje definira HTML, a ne ECMAScript. Mjerači vremena dostupni su u kontekstima window i worker; podrška u Nodeu 24 ne dokazuje podršku za API preglednika. U pregledniku setTimeout() pretvara odgodu u 32-bitni cijeli broj s predznakom. Primjerice, 2147483648 ms pretvara se u negativnu vrijednost koja se tretira kao nula. Odgoda ne jamči točno vrijeme izvršavanja: drugi zadaci mogu ga produljiti, a za dovoljno ugniježđene mjerače vrijedi minimum od 4 ms. Ovo nije mehanizam za rad u stvarnom vremenu.
Omotač stvorite jednom i ponovno ga upotrebljavajte; stvaranjem novog za svaki događaj gubi se zajedničko stanje. Primjer pretpostavlja valjan fn i cjelobrojnu vrijednost wait u milisekundama koja zadovoljava uvjet 0 <= wait && wait <= 2147483647. Ne prosljeđuje povratnu vrijednost funkcije i ne nudi cancel(), flush() ni maxWait. U produkcijskom kodu organizirajte otkazivanje posla na čekanju pri uklanjanju komponente. Otkazivanje mjerača vremena ne zaustavlja već pokrenut zahtjev niti štiti od zastarjelih odgovora.
Primjeri
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);
}Rezultat
throttle: A debounce: C
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.