Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Debounce i throttle: upravljanje pozivima funkcija

Debounce odgađa izvršavanje dok se niz poziva ne smiri, a throttle ograničava učestalost izvršavanja tijekom niza. Razlikujte varijante leading i trailing: one određuju zadržava li se prvi poziv, posljednji ili oba.

Verzija: 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 obrasci su za upravljanje pozivima, a ne ugrađene funkcije ECMAScripta. Trailing debounce izvršava funkciju nakon razdoblja mirovanja wait: svaki novi poziv otkazuje prethodni mjerač vremena i zakazuje novi. Zadržava najnovije argumente i this. Prikladan je, primjerice, za pokretanje pretraživanja nakon stanke u tipkanju; neprekidni pozivi mogu odgađati izvršavanje unedogled.

Throttle ograničava učestalost izvršavanja čak i dok pozivi stalno pristižu. Varijanta leading u primjeru odmah izvršava prvi poziv, a zatim odbacuje sljedeće dok je mjerač vremena ponovno ne odblokira. Ne izvršava posljednji odbačeni poziv. Može poslužiti za ograničavanje učestalosti obrade pomicanja. Leading znači izvršavanje na početku vremenskog prozora, a trailing odgođeno izvršavanje na njegovu kraju. Implementacije mogu nuditi obje varijante, pa ta pravila izričito odredite.

Primjer koristi sintaksu ECMAScripta 2015 te setTimeout() i clearTimeout() preglednika, koje definira HTML, a ne ECMAScript. Mjerači vremena dostupni su u kontekstima window i worker; podrška u Nodeu 24 ne dokazuje podršku za API preglednika. U pregledniku setTimeout() pretvara odgodu u 32-bitni cijeli broj s predznakom. Primjerice, 2147483648 ms pretvara se u negativnu vrijednost koja se tretira kao nula. Odgoda ne jamči točno vrijeme izvršavanja: drugi zadaci mogu ga produljiti, a za dovoljno ugniježđene mjerače vrijedi minimum od 4 ms. Ovo nije mehanizam za rad u stvarnom vremenu.

Omotač stvorite jednom i ponovno ga upotrebljavajte; stvaranjem novog za svaki događaj gubi se zajedničko stanje. Primjer pretpostavlja valjan fn i cjelobrojnu vrijednost wait u milisekundama koja zadovoljava uvjet 0 <= wait && wait <= 2147483647. Ne prosljeđuje povratnu vrijednost funkcije i ne nudi cancel(), flush() ni maxWait. U produkcijskom kodu organizirajte otkazivanje posla na čekanju pri uklanjanju komponente. Otkazivanje mjerača vremena ne zaustavlja već pokrenut zahtjev niti štiti od zastarjelih odgovora.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori