Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

`throttle` — obmedzenie frekvencie spúšťania funkcie

`throttle` obmedzuje frekvenciu spúšťania funkcie aj pri nepretržitom prúde volaní. Hodí sa napríklad na zníženie množstva práce pri posúvaní stránky.

Verzia: 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 je bežný názov pomocnej funkcie, nie vstavaná funkcia ECMAScriptu ani štandardné API prehliadača. Vracia obalovú funkciu, ktorá obmedzuje frekvenciu spúšťania fn. Vďaka tomu môžeš napríklad menej často aktualizovať rozhranie pri posúvaní stránky. Obalovú funkciu vytvor raz a opakovane ju používaj: každá si pamätá vlastný čas posledného spustenia.

V príklade prvé volanie spustí fn okamžite (leading edge). Ďalšie volanie ju môže spustiť, keď od predchádzajúceho spustenia uplynie aspoň intervalMs. Príliš skoré volania vrátia undefined, nepredĺžia interval a nezaradia sa do frontu. Prijaté volanie odovzdá this aj argumenty a vráti výsledok fn alebo nechá jej výnimku prejsť ďalej.

Iné varianty môžu na konci intervalu vykonať posledné čakajúce volanie (trailing edge). Tu samotné uplynutie času nič nespustí. Bežný debounce, ktorý sa vykonáva na konci série, čaká na prestávku medzi volaniami; throttle môže funkciu spúšťať aj bez prestávky.

Zadaj kladný konečný interval a funkciu now, ktorá vracia konečné, neklesajúce časové hodnoty v milisekundách. Príklad používa simulované hodiny; v prehliadači môžeš odovzdať () => performance.now(). Ide o API webovej platformy, preto over dostupnosť v cieľovom prostredí. Ak iný variant používa setTimeout(), jeho spätné volanie sa môže spustiť neskôr, než bolo naplánované.

Prí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ýsledok

Update: A
Update: C

A sa spustí v čase 0 ms, B sa preskočí pri 40 ms, C sa spustí presne na hranici 100 ms a D sa pri 140 ms preskočí a neskôr sa už nespustí.

Súvisiace lekcie

  • JavaScript · Lekcia 21 · Základná · Verzia: 4

Zdroje