KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

debounce: uitvoeren na een pauze

`debounce` bundelt snel opeenvolgende aanroepen. In de getoonde variant wordt na een pauze alleen de laatste aanroep uitgevoerd.

Versie: User-defined debounce helper using web timers; host timer behavior varies

Syntax

const debounced = debounce(fn, waitMs);
debounced(...args);
debounced.cancel();

debounce(fn, waitMs) geeft een wrapperfunctie voor fn terug. Geef de functie fn mee, niet het resultaat van een aanroep ervan, en een niet-negatieve wachttijd waitMs in milliseconden. Maak de wrapper één keer per bron van aanroepen en hergebruik hem, bijvoorbeeld om resultaten te filteren zodra iemand even stopt met typen.

Bij de variant aan het einde van een reeks (trailing edge) annuleert elke aanroep de wachtende timer en start een nieuwe. Zodra de timer afgaat, wordt fn één keer uitgevoerd met de argumenten en de this-waarde van de laatste aanroep van de wrapper. Blijven de aanroepen elkaar snel genoeg opvolgen, dan wordt fn mogelijk nooit uitgevoerd. Throttling begrenst daarentegen de uitvoeringsfrequentie, ook terwijl de aanroepen doorgaan. De variant aan het begin van de reeks (leading edge) voert fn meteen bij de eerste aanroep uit; het voorbeeld doet dat niet.

Elke wrapper heeft een eigen timer. De methode cancel() uit het voorbeeld schrapt een geplande uitvoering, maar stopt geen werk dat al is begonnen. De wrapper geeft meteen undefined terug, niet het latere resultaat van fn. Een uitzondering die fn in de timercallback opwerpt, bereikt de eerdere aanroeper van de wrapper niet.

Het voorbeeld definieert debounce en de methode cancel(); geen van beide is gedefinieerd in ECMAScript of een webstandaard. De versieaanduiding verwijst naar de standaarden waarop het voorbeeld steunt, niet naar de hulpfunctie zelf. Het voorbeeld gebruikt setTimeout en clearTimeout van de uitvoeringsomgeving. Kies voor waitMs een waarde binnen het bereik dat de timers van de uitvoeringsomgeving ondersteunen: een te hoge waarde kan als een veel kortere wachttijd worden behandeld. De timer kan later afgaan dan gevraagd. Controleer buiten de browser of de omgeving timers biedt en hoe die werken.

Voorbeelden

(() => {
  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');
})();

Resultaat

Search: cat

Voer het volledige fragment in één keer uit in de browserconsole. De drie aanroepen zijn synchroon, dus alleen de laatste leidt tot de uitvoer `Search: cat`. De 100 ms garanderen geen exact uitvoeringstijdstip.

Gerelateerde lessen

  • JavaScript · Les 21 · Basis · Versie: 4

Bronnen