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

CKTIS / JavaScript

Debounce in throttle: nadzor klicev funkcij

Debounce odloži izvajanje, dokler se niz klicev ne umiri, throttle pa med nizom omeji pogostost izvajanja. Razlikujte različici leading in trailing: določata, ali se ohrani prvi klic, zadnji ali oba.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);

debounce / throttle sta vzorca za nadzor klicev, ne vgrajeni funkciji ECMAScript. Različica trailing debounce izvede funkcijo po obdobju mirovanja wait: vsak nov klic prekliče prejšnji časovnik in načrtuje novega. Ohrani najnovejše argumente in this. Primerna je na primer za začetek iskanja po premoru med tipkanjem; neprekinjeni klici lahko izvajanje odlagajo v nedogled.

Throttle omeji pogostost izvajanja, tudi kadar klici še naprej prihajajo. Različica leading v primeru prvi klic izvede takoj, nato pa zavrača naslednje, dokler je časovnik znova ne odblokira. Zadnjega zavrnjenega klica ne izvede. Uporabna je lahko za omejevanje pogostosti obdelave drsenja. Leading pomeni izvedbo na začetku časovnega okna, trailing pa odloženo izvedbo na njegovem koncu. Implementacije lahko ponujajo obe različici, zato ta pravila izrecno določite.

Primer uporablja sintakso ECMAScript 2015 ter brskalniška setTimeout() in clearTimeout(), ki ju določa HTML, ne ECMAScript. Časovniki so na voljo v kontekstih window in worker; podpora v Node 24 ne dokazuje podpore brskalniškega API-ja. V brskalniku setTimeout() pretvori zakasnitev v 32-bitno celo število s predznakom. Vrednost 2147483648 ms se na primer pretvori v negativno vrednost, ki se obravnava kot nič. Zakasnitev ne zagotavlja točnega časa izvedbe: druge naloge jo lahko podaljšajo, za dovolj globoko vgnezdene časovnike pa velja najmanj 4 ms. To ni mehanizem za sprotno izvajanje.

Ovojnico ustvarite enkrat in jo ponovno uporabljajte; če jo ustvarite za vsak dogodek znova, izgubite skupno stanje. Primer predpostavlja veljaven fn in celoštevilsko vrednost wait v milisekundah, ki izpolnjuje pogoj 0 <= wait && wait <= 2147483647. Ne posreduje vrnjene vrednosti funkcije ter ne ponuja cancel(), flush() ali maxWait. V produkcijski kodi poskrbite za preklic čakajočega dela ob odstranitvi komponente. Preklic časovnika ne ustavi že začete zahteve in ne ščiti pred zastarelimi odgovori.

Primeri

function debounce(fn, wait) {
  let timer;
  return function (...args) {
    clearTimeout(timer);
    timer = setTimeout(() => {
      timer = undefined;
      fn.apply(this, args);
    }, wait);
  };
}

function throttle(fn, wait) {
  let blocked = false;
  return function (...args) {
    if (blocked) return;
    blocked = true;
    setTimeout(() => { blocked = false; }, wait);
    fn.apply(this, args);
  };
}

const debounced = debounce(value => console.log('debounce:', value), 50);
const throttled = throttle(value => console.log('throttle:', value), 50);

for (const value of ['A', 'B', 'C']) {
  debounced(value);
  throttled(value);
}

Rezultat

throttle: A
debounce: C

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri