CKTIS / JavaScript
`throttle` — limiter la fréquence d’exécution d’une fonction
`throttle` limite la fréquence d’exécution d’une fonction même si les appels se succèdent sans pause. Cela réduit par exemple le travail effectué lors d’un défilement.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.throttle est le nom courant d’une fonction utilitaire, pas une fonction intégrée à ECMAScript ni une API standard du navigateur. Elle renvoie une fonction enveloppante qui limite la fréquence de lancement de fn. On peut ainsi actualiser l’interface moins souvent pendant un défilement. Créez cette fonction enveloppante une seule fois et réutilisez-la : chacune mémorise son propre dernier instant de démarrage.
Dans l’exemple, le premier appel exécute fn immédiatement (leading edge). Un nouvel appel peut l’exécuter si au moins intervalMs se sont écoulées depuis le démarrage précédent. Les appels trop précoces renvoient undefined, ne prolongent pas l’intervalle et ne sont pas mis en attente. Un appel accepté transmet this et les arguments, puis renvoie le résultat de fn ou propage son exception.
D’autres variantes peuvent exécuter le dernier appel en attente à la fin de l’intervalle (trailing edge). Ici, le simple écoulement du temps ne déclenche rien. Un debounce classique en fin de série attend une pause entre les appels ; throttle peut continuer à exécuter la fonction sans pause.
Fournissez un intervalle positif et fini et une fonction d’horloge now qui renvoie des valeurs finies, non décroissantes, en millisecondes. L’exemple utilise une horloge simulée ; dans un navigateur, vous pouvez passer () => performance.now(). C’est une API de la plateforme web : vérifiez sa disponibilité dans l’environnement cible. Si une autre variante utilise setTimeout(), sa fonction de rappel peut s’exécuter plus tard que prévu.
Exemples
{
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");
}Résultat
Update: A Update: C
A s’exécute à 0 ms, B est ignoré à 40 ms, C s’exécute exactement au seuil de 100 ms et D est ignoré à 140 ms sans être exécuté plus tard.
Leçons associées
- JavaScript · Leçon 21 · Débutant · Version : 4