CKTIS / JavaScript
Debounce e throttle: controllare le chiamate alle funzioni
Debounce rinvia l’esecuzione finché una serie di chiamate non si interrompe, mentre throttle limita la frequenza di esecuzione durante la serie. Distingui le varianti leading e trailing: stabiliscono se mantenere la prima chiamata, l’ultima o entrambe.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const debounced = debounce(fn, wait);
const throttled = throttle(fn, wait);
debounced(...args);
throttled(...args);debounce / throttle sono schemi per controllare le chiamate, non funzioni integrate in ECMAScript. Il debounce trailing esegue una funzione dopo un periodo di inattività di wait: ogni nuova chiamata annulla il timer precedente e ne programma un altro. Mantiene gli argomenti più recenti e this. È adatto, per esempio, ad avviare una ricerca dopo una pausa nella digitazione; chiamate continue possono rinviare l’esecuzione all’infinito.
Throttle limita la frequenza di esecuzione anche quando continuano ad arrivare chiamate. La variante leading dell’esempio esegue subito la prima chiamata, poi scarta le successive finché un timer non la sblocca. Non esegue l’ultima chiamata scartata. Può essere usato per limitare la frequenza di gestione dello scorrimento. Leading indica l’esecuzione all’inizio di una finestra; trailing l’esecuzione rinviata alla fine. Le implementazioni possono offrire entrambe le varianti: definisci esplicitamente queste regole.
L’esempio usa la sintassi ECMAScript 2015 e setTimeout() e clearTimeout() del browser, specificati da HTML e non da ECMAScript. I timer sono disponibili nei contesti window e worker; il supporto in Node 24 non dimostra il supporto dell’API del browser. Nel browser, setTimeout() converte il ritardo in un intero con segno a 32 bit. Per esempio, 2147483648 ms diventa un valore negativo che viene trattato come zero. Un ritardo non garantisce un momento di esecuzione esatto: altre attività possono posticiparlo e per i timer sufficientemente annidati vale un minimo di 4 ms. Non è un meccanismo in tempo reale.
Crea il wrapper una volta e riutilizzalo; ricrearlo per ogni evento fa perdere lo stato condiviso. L’esempio presuppone un fn valido e un valore intero di wait in millisecondi che soddisfi 0 <= wait && wait <= 2147483647. Non inoltra il valore restituito dalla funzione e non offre cancel(), flush() o maxWait. In produzione, organizza l’annullamento del lavoro in attesa quando rimuovi un componente. Annullare un timer non interrompe una richiesta già avviata e non protegge dalle risposte obsolete.
Esempi
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);
}Risultato
throttle: A debounce: C
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.