CKTIS / JavaScript
debounce: izvršavanje nakon stanke
`debounce` sažima niz brzih poziva u jedan. U prikazanoj se varijanti nakon stanke izvršava samo posljednji poziv.
Verzija: User-defined debounce helper using web timers; host timer behavior varies
Sintaksa
const debounced = debounce(fn, waitMs);
debounced(...args);
debounced.cancel();debounce(fn, waitMs) vraća omotač za funkciju fn. Proslijedi samu funkciju fn, a ne rezultat njezina poziva, te nenegativnu odgodu waitMs u milisekundama. Za svaki izvor poziva stvori omotač samo jednom i ponovno ga upotrebljavaj, primjerice za filtriranje rezultata nakon stanke u tipkanju.
U varijanti na kraju niza (trailing edge) svaki poziv poništava postojeći mjerač vremena i pokreće novi. Kad mjerač napokon istekne, fn se izvršava jednom uz argumente i vrijednost this iz posljednjeg poziva omotača. Ako pozivi i dalje pristižu dovoljno brzo, fn se možda uopće neće izvršiti. Nasuprot tome, throttling ograničava učestalost izvršavanja i dok pozivi pristižu. Varijanta na početku niza (leading edge) izvršava fn odmah pri prvom pozivu; primjer to ne radi.
Svaki omotač ima vlastiti mjerač vremena. Metoda cancel() iz primjera otkazuje izvršavanje na čekanju, ali ne zaustavlja posao koji je već počeo. Omotač odmah vraća undefined, a ne kasniji rezultat funkcije fn. Iznimka koju fn baci u povratnoj funkciji mjerača vremena ne prenosi se do koda koji je ranije pozvao omotač.
Funkcija debounce i njezina metoda cancel() definirane su u primjeru, a ne u ECMAScriptu ili web standardu. Podatak o verziji odnosi se na standarde na koje se primjer oslanja, a ne na samu pomoćnu funkciju. Primjer koristi setTimeout i clearTimeout koje pruža okruženje. Odaberi vrijednost waitMs unutar raspona koji podržavaju mjerači vremena u tom okruženju: previsoka vrijednost može se protumačiti kao mnogo kraća odgoda. Mjerač vremena može isteći kasnije nego što je zatraženo. Izvan preglednika provjeri pruža li okruženje mjerače vremena i kako oni rade.
Primjeri
(() => {
function debounce(fn, waitMs) {
let timer;
function cancel() {
if (timer !== undefined) {
clearTimeout(timer);
timer = undefined;
}
}
function debounced(...args) {
cancel();
timer = setTimeout(() => {
timer = undefined;
Reflect.apply(fn, this, args);
}, waitMs);
}
debounced.cancel = cancel;
return debounced;
}
const search = {
prefix: 'Search: ',
update: debounce(function (query) {
console.log(this.prefix + query);
}, 100),
};
search.update('c');
search.update('ca');
search.update('cat');
})();Rezultat
Search: cat
Pokreni sav kôd odjednom u konzoli preglednika. Tri su poziva sinkrona, pa samo posljednji dovodi do ispisa `Search: cat`. Odgoda od 100 ms ne jamči točan trenutak izvršavanja.
Povezane lekcije
- JavaScript · Lekcija 21 · Osnovno · Verzija: 4