Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

`throttle` — omezení četnosti spouštění funkce

`throttle` omezuje četnost spouštění funkce, i když volání přicházejí nepřetržitě. Hodí se například ke snížení množství práce při posouvání stránky.

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

Syntaxe

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

throttle je běžné označení pomocné funkce, nikoli vestavěná funkce ECMAScriptu ani standardní API prohlížeče. Vrací obalovou funkci, která omezuje, jak často se fn spouští. Díky tomu lze například méně často aktualizovat rozhraní při posouvání stránky. Obalovou funkci vytvoř jednou a používej ji opakovaně: každá si pamatuje vlastní čas posledního spuštění.

V příkladu první volání spustí fn hned (leading edge). Další volání ji může spustit, pokud od předchozího spuštění uplynulo alespoň intervalMs. Příliš brzká volání vrátí undefined, neprodlouží interval a nezařadí se do fronty. Přijaté volání předá this i argumenty a vrátí výsledek fn nebo nechá její výjimku projít dál.

Jiné varianty mohou na konci intervalu spustit poslední čekající volání (trailing edge). Zde samotné uplynutí času nic nespustí. Běžný debounce se spuštěním na konci série čeká na pauzu mezi voláními; throttle může funkci spouštět i bez pauzy.

Zadej kladný konečný interval a funkci now, která vrací konečné, neklesající časové hodnoty v milisekundách. Příklad používá simulované hodiny; v prohlížeči můžeš předat () => performance.now(). Jde o API webové platformy, proto ověř dostupnost v cílovém prostředí. Pokud jiná varianta používá setTimeout(), může se její zpětné volání spustit později, než bylo naplánováno.

Příklady

{
  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");
}

Výsledek

Update: A
Update: C

A se spustí v čase 0 ms, B se přeskočí při 40 ms, C se spustí přesně na hranici 100 ms a D se při 140 ms přeskočí a později se už nespustí.

Související lekce

  • JavaScript · Lekce 21 · Základní · Verze: 4

Zdroje