Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

`throttle` — omejevanje pogostosti izvajanja funkcije

`throttle` omeji pogostost izvajanja funkcije, tudi če klici prihajajo brez premora. Uporaben je na primer za zmanjšanje obsega dela med pomikanjem po strani.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

throttle je običajno ime pomožne funkcije, ne pa vgrajena funkcija ECMAScripta ali standardni API brskalnika. Vrne ovojno funkcijo, ki omeji, kako pogosto se zažene fn. Tako lahko na primer med pomikanjem po strani redkeje posodabljaš vmesnik. Ovojno funkcijo ustvari enkrat in jo uporabljaj znova: vsaka si zapomni svoj čas zadnjega zagona.

V primeru prvi klic takoj izvede fn (leading edge). Naslednji klic jo lahko izvede, ko od prejšnjega zagona mine najmanj intervalMs. Prezgodnji klici vrnejo undefined, ne podaljšajo intervala in se ne postavijo v čakalno vrsto. Sprejeti klic posreduje this in argumente ter vrne rezultat fn ali prepusti njeno izjemo klicatelju.

Druge različice lahko ob koncu intervala izvedejo zadnji čakajoči klic (trailing edge). Tu sam potek časa ne sproži ničesar. Običajen debounce z izvedbo na koncu čaka na premor med klici; throttle lahko funkcijo izvaja tudi brez premora.

Podaj pozitiven končen interval in funkcijo now, ki vrača končne, nepadajoče časovne vrednosti v milisekundah. Primer uporablja simulirano uro; v brskalniku lahko podaš () => performance.now(). To je API spletne platforme, zato preveri razpoložljivost v ciljnem izvajalnem okolju. Če druga različica uporablja setTimeout(), se lahko njena povratna funkcija izvede pozneje, kot je bilo načrtovano.

Primeri

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

Rezultat

Update: A
Update: C

A se izvede pri 0 ms, B se pri 40 ms preskoči, C se izvede točno na meji 100 ms, D pa se pri 140 ms preskoči in se pozneje ne izvede.

Povezane lekcije

  • JavaScript · Lekcija 21 · Osnovna · Različica: 4

Viri