CKTIS / JavaScript
debounce: izvedba po premoru
`debounce` združi niz hitrih klicev v enega. V prikazani različici se po premoru izvede samo zadnji klic.
Različica: User-defined debounce helper using web timers; host timer behavior varies
Sintaksa
const debounced = debounce(fn, waitMs);
debounced(...args);
debounced.cancel();debounce(fn, waitMs) vrne ovojno funkcijo za fn. Podaj funkcijo fn, ne rezultata njenega klica, ter nenegativen zamik waitMs v milisekundah. Za vsak vir klicev ustvari ovojno funkcijo samo enkrat in jo znova uporabljaj, na primer za filtriranje rezultatov po premoru med tipkanjem.
Pri različici na koncu niza (trailing edge) vsak klic prekliče čakajoči časovnik in nastavi novega. Ko se časovnik končno sproži, se fn izvede enkrat z argumenti in vrednostjo this iz zadnjega klica ovojne funkcije. Če si klici še naprej sledijo dovolj hitro, se fn morda nikoli ne izvede. Nasprotno pa throttling omejuje pogostost izvajanja tudi med neprekinjenim nizom klicev. Različica na začetku niza (leading edge) izvede fn takoj ob prvem klicu; primer tega ne počne.
Vsaka ovojna funkcija ima svoj časovnik. Metoda cancel() v primeru prekliče čakajočo izvedbo, ne ustavi pa dela, ki se je že začelo. Ovojna funkcija takoj vrne undefined, ne poznejšega rezultata fn. Izjema, ki jo fn sproži v povratni funkciji časovnika, se ne prenese nazaj v kodo, ki je pred tem poklicala ovojno funkcijo.
Funkcija debounce in njena metoda cancel() sta definirani v primeru, ne pa v ECMAScriptu ali spletnem standardu. Podatek o različici se nanaša na standarde, na katere se primer opira, ne na samo pomožno funkcijo. Primer uporablja setTimeout in clearTimeout, ki ju zagotavlja gostiteljsko okolje. Izberi waitMs v razponu, ki ga podpirajo časovniki tega okolja: previsoka vrednost se lahko obravnava kot precej krajši zamik. Časovnik se lahko sproži pozneje, kot je zahtevano. Zunaj brskalnika preveri, ali in kako izvajalno okolje zagotavlja časovnike.
Primeri
(() => {
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
Celotno kodo zaženi naenkrat v konzoli brskalnika. Vsi trije klici so sinhroni, zato samo zadnji povzroči izpis `Search: cat`. Zamik 100 ms ne zagotavlja natančnega časa izvedbe.
Povezane lekcije
- JavaScript · Lekcija 21 · Osnovna · Različica: 4