CKTIS / JavaScript
Debounce en throttle: functieaanroepen beheersen
Debounce stelt de uitvoering uit totdat een reeks aanroepen tot rust komt, terwijl throttle de uitvoeringsfrequentie tijdens die reeks beperkt. Maak onderscheid tussen leading- en trailing-varianten: die bepalen of de eerste aanroep, de laatste of beide behouden blijven.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle zijn patronen om aanroepen te beheersen, geen ingebouwde ECMAScript-functies. Trailing-debounce voert een functie uit na een stille periode van wait: elke nieuwe aanroep annuleert de vorige timer en plant een nieuwe. De meest recente argumenten en this blijven behouden. Dit is bijvoorbeeld geschikt om een zoekactie te starten nadat iemand even niet heeft getypt; doorlopende aanroepen kunnen de uitvoering onbeperkt uitstellen.
Throttle beperkt de uitvoeringsfrequentie, ook als er voortdurend aanroepen binnenkomen. De leading-variant in het voorbeeld voert de eerste aanroep direct uit en verwerpt daarna volgende aanroepen totdat een timer de blokkering opheft. De verworpen laatste aanroep wordt niet uitgevoerd. Dit kan helpen om de frequentie van scrollverwerking te beperken. Leading betekent uitvoering aan het begin van een venster; trailing betekent uitgestelde uitvoering aan het einde. Implementaties kunnen beide varianten aanbieden; leg deze regels dus expliciet vast.
Het voorbeeld gebruikt ECMAScript 2015-syntaxis en setTimeout() en clearTimeout() van de browser, die door HTML en niet door ECMAScript zijn gespecificeerd. Timers zijn beschikbaar in window- en worker-contexten; ondersteuning in Node 24 bewijst geen ondersteuning van de browser-API. In de browser zet setTimeout() de vertraging om in een 32-bits geheel getal met teken. Zo wordt 2147483648 ms omgezet in een negatieve waarde die als nul wordt behandeld. Een vertraging garandeert geen exact uitvoeringstijdstip: andere taken kunnen de uitvoering uitstellen en voor voldoende diep geneste timers geldt een minimum van 4 ms. Dit is geen realtime-mechanisme.
Maak de wrapper één keer en hergebruik hem; als je hem voor elk event opnieuw maakt, gaat de gedeelde status verloren. Het voorbeeld gaat uit van een geldige fn en een gehele waarde voor wait in milliseconden waarvoor 0 <= wait && wait <= 2147483647 geldt. Het geeft de retourwaarde van de functie niet door en biedt geen cancel(), flush() of maxWait. Zorg er in productie voor dat je werk in de wachtrij annuleert wanneer je een component verwijdert. Een timer annuleren stopt geen al gestarte aanvraag en beschermt niet tegen verouderde antwoorden.
Voorbeelden
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);
}Resultaat
throttle: A debounce: C
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.