CKTIS / JavaScript
`throttle`: limitare la frequenza di esecuzione di una funzione
`throttle` limita la frequenza di esecuzione di una funzione anche quando le chiamate arrivano di continuo. È utile, per esempio, durante lo scorrimento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.throttle è un nome convenzionale per una funzione di supporto, non una funzione integrata in ECMAScript né un’API standard del browser. Restituisce una funzione wrapper che limita la frequenza con cui viene avviata fn. Per esempio, puoi aggiornare l’interfaccia meno spesso durante lo scorrimento. Crea il wrapper una volta sola e riutilizzalo: ciascun wrapper tiene traccia del proprio ultimo avvio.
Nell’esempio, la prima chiamata esegue subito fn (leading edge). Un’altra chiamata può eseguirla quando sono trascorsi almeno intervalMs dall’avvio precedente. Le chiamate troppo ravvicinate restituiscono undefined, non prolungano l’intervallo e non vengono accodate. Una chiamata accettata inoltra this e gli argomenti e restituisce il risultato di fn o ne propaga l’eccezione.
Altre varianti possono eseguire l’ultima chiamata in attesa alla fine dell’intervallo (trailing edge). Qui il solo trascorrere del tempo non avvia nulla. Un tipico debounce con esecuzione finale attende una pausa tra le chiamate; throttle può continuare a eseguire la funzione anche senza una pausa.
Fornisci un intervallo positivo e finito e una funzione now che restituisca valori temporali finiti e non decrescenti in millisecondi. L’esempio usa un orologio simulato; in un browser puoi passare () => performance.now(). È un’API della piattaforma web: verificane la disponibilità nell’ambiente di destinazione. Se un’altra variante usa setTimeout(), la sua callback può essere eseguita più tardi del previsto.
Esempi
{
function throttle(fn, intervalMs, now) {
let lastRun;
return function (...args) {
const time = now();
if (lastRun !== undefined && time - lastRun < intervalMs) {
return undefined;
}
lastRun = time;
return Reflect.apply(fn, this, args);
};
}
let time = 0;
const panel = {
prefix: "Update",
update: throttle(function (label) {
console.log(`${this.prefix}: ${label}`);
}, 100, () => time),
};
panel.update("A");
time = 40;
panel.update("B");
time = 100;
panel.update("C");
time = 140;
panel.update("D");
}Risultato
Update: A Update: C
A viene eseguita a 0 ms, B viene ignorata a 40 ms, C viene eseguita esattamente alla soglia dei 100 ms e D viene ignorata a 140 ms, senza essere eseguita in seguito.
Lezioni correlate
- JavaScript · Lezione 21 · Base · Versione: 4