KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`throttle` — beperken hoe vaak een functie draait

`throttle` beperkt hoe vaak een functie wordt uitgevoerd, ook als aanroepen blijven binnenkomen. Dat vermindert bijvoorbeeld het werk tijdens het scrollen.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.

throttle is een gebruikelijke naam voor een hulpfunctie, geen ingebouwde ECMAScript-functie of standaardbrowser-API. De hulpfunctie geeft een wrapper terug die beperkt hoe vaak fn start. Zo kun je de interface bijvoorbeeld minder vaak bijwerken tijdens het scrollen. Maak de wrapper één keer en hergebruik hem: elke wrapper onthoudt zijn eigen laatste starttijd.

In dit voorbeeld voert de eerste aanroep fn meteen uit (leading edge). Een volgende aanroep kan fn uitvoeren zodra er minstens intervalMs sinds de vorige start zijn verstreken. Te vroege aanroepen geven undefined terug, verlengen het interval niet en worden niet in een wachtrij gezet. Een geaccepteerde aanroep geeft this en de argumenten door en laat het resultaat of de exceptie van fn door.

Andere varianten kunnen de laatste wachtende aanroep aan het einde van het interval uitvoeren (trailing edge). Hier start er niets door alleen het verstrijken van de tijd. Een typische debounce met uitvoering aan het einde wacht op een pauze tussen aanroepen; throttle kan de functie ook zonder pauze blijven uitvoeren.

Geef een positief, eindig interval en een klokfunctie now op die eindige, niet-dalende waarden in milliseconden oplevert. Het voorbeeld gebruikt een gesimuleerde klok; in een browser kun je () => performance.now() doorgeven. Dit is een API van het webplatform: controleer de beschikbaarheid in je doelomgeving. Gebruikt een andere variant setTimeout(), dan kan de callback later dan gepland draaien.

Voorbeelden

{
  function throttle(fn, intervalMs, now) {
    let lastRun;
    return function (...args) {
      const time = now();
      if (lastRun !== undefined && time - lastRun < intervalMs) {
        return undefined;
      }
      lastRun = time;
      return Reflect.apply(fn, this, args);
    };
  }

  let time = 0;
  const panel = {
    prefix: "Update",
    update: throttle(function (label) {
      console.log(`${this.prefix}: ${label}`);
    }, 100, () => time),
  };

  panel.update("A");
  time = 40;
  panel.update("B");
  time = 100;
  panel.update("C");
  time = 140;
  panel.update("D");
}

Resultaat

Update: A
Update: C

A draait bij 0 ms, B wordt overgeslagen bij 40 ms, C draait precies op de grens van 100 ms en D wordt overgeslagen bij 140 ms zonder later alsnog te draaien.

Gerelateerde lessen

  • JavaScript · Les 21 · Basis · Versie: 4

Bronnen