Izdanje Node.js 26.10.0 dodalo je debounce i throttle u standardnu biblioteku

Odlaganje reakcije na događaj koji se prebrzo ponavlja i ograničavanje broja poziva prema tuđem servisu dva su najčešća razloga zbog kojih projekat na Node.js platformi dodaje zavisnost koja mu inače ne treba. Izdanje Node.js 26.10.0 objavljeno je 22. septembra 2026. Obje funkcije od tada postoje u modulu node:util. Nijedna nije tanka kopija onoga što npm već nudi: svaka vraća asinhroni rezultat, prima signal prekida i kaže šta se dešava s pozivom koji neće izvršiti.

Kako radi debounce

util.debounce(fn, wait[, options]) vraća funkciju koja odlaže poziv funkcije fn dok od posljednjeg poziva ne prođe zadati broj milisekundi. Vraćena funkcija daje asinhroni rezultat onoga što je fn proizvela, a ako fn baci grešku ili vrati odbijen rezultat, i taj rezultat se odbija s istim razlogom. Kad se funkcija pozove više puta unutar istog prozora, fn dobija argumente posljednjeg od tih poziva.

Opcije određuju šta se dešava s pozivima koji su prestignuti. Podrazumijevano se svaki takav poziv razriješi rezultatom onog poziva koji je stvarno izvršen. Uz opciju rejectOnCancel ti pozivi umjesto toga budu odbijeni greškom AbortError, a to treba pozivaocu koji mora da zna da je njegov posao odbačen. Opcija leading poziva fn odmah na početku prozora, a vraćena funkcija ima i metod cancel.

Throttle ograničava učestalost, a nije tajmer

util.throttle(fn, limit, interval[, options]) ograničava broj poziva na zadatu vrijednost po intervalu u milisekundama. Kapacitet tempa se troši kad fn krene, a ne kad poziv uđe u red čekanja, dok se kapacitet istovremenosti oslobađa tek kad vraćena vrijednost bude razriješena. Dokumentacija to pravilo sažima u jednu rečenicu, navedenu ispod.

Pozivi preko granice podrazumijevano čekaju u redu, onim redom kojim su stigli. Kad se overflow postavi na drop, oni budu odbijeni odmah, greškom ERR_THROTTLED, a maxPending ograničava dužinu reda kad se red zadrži. Odbijen poziv se vraća kao asinhroni rezultat koji je već označen kao obrađen, pa njegovo zanemarivanje ne podiže prijavu neobrađenog odbijanja.

• concurrency ograničava koliko poziva istovremeno smije imati nerazriješenu povratnu vrijednost, a podrazumijevana vrijednost je Infinity.
• strict čuva granicu u svakom pomičnom intervalu, a ne samo u nepokretnim prozorima.
• Prekinut signal poništava pozive na čekanju i sprečava buduće, i to kod obje funkcije.

Ostatak izdanja

Još devet stavki iz spiska značajnijih izmjena označeno je kao semver-minor. Funkcija util.markPromiseAsHandled(promise) označava asinhroni rezultat tako da se njegovo odbijanje ne prijavljuje kao neobrađeno, a to je isti mehanizam koji throttle primjenjuje na pozive koje sam odbije.

• crypto.parsePKCS12() čita paket u formatu PKCS#12.
• fs.openAsBlobSync je sinhroni parnjak funkcije openAsBlob.
• Modul net sada umije da pošalje net.BoundSocket radnim nitima i podređenim procesima.
• perf_hooks dobija SlidingWindowHistogram i qrde analizu unutar Histogram.
• sqlite sada vezuje undefined za NULL, a ffi može da učita biblioteke s montiranog virtuelnog sistema datoteka.

Šta to mijenja u projektu

Zavisnost koja postoji samo da bi odložila reakciju na događaj sada može da izađe iz datoteke package.json, a isto važi i za ručno pisan ograničavač poziva ispred tuđeg API-ja. Na serveru to manje znači za veličinu, a više za lanac snabdijevanja: svaki uklonjen paket je jedan manje za provjeru i jedan manje za ažuriranje.

Stranica izdanja ovo izdanje označava kao Current, a u bilješkama nema nijedne bezbjednosne ispravke, pa nadogradnja nije hitna. Jedna stavka zaslužuje da se pročita prije nje: sqlite sada vezuje undefined za NULL, što mijenja šta upit radi s nedostajućom vrijednošću, umjesto da nešto dodaje.