Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori