CKTIS / JavaScript
`throttle` — ограничаване на честотата на изпълнение на функция
`throttle` ограничава честотата на изпълнение на функция дори при непрекъснати извиквания. Полезно е например за намаляване на натоварването при превъртане.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const limited = throttle(fn, intervalMs, now);
limited(...args);
// Signature of the helper defined below; now is a function returning milliseconds.throttle е обичайно име на помощна функция, а не вградена функция на ECMAScript или стандартен API на браузъра. Тя връща обвиваща функция, която ограничава колко често се стартира fn. Така например можеш да обновяваш интерфейса по-рядко при превъртане. Създай обвиващата функция веднъж и я използвай многократно: всяка пази собственото си време на последно стартиране.
В примера първото извикване изпълнява fn веднага (leading edge). Следващо извикване може да я изпълни, когато от предишното стартиране са изминали поне intervalMs. Твърде ранните извиквания връщат undefined, не удължават интервала и не се нареждат на опашка. Приетото извикване предава this и аргументите и връща резултата от fn или предава нейното изключение нататък.
Други варианти могат да изпълнят последното чакащо извикване в края на интервала (trailing edge). Тук самото изтичане на времето не стартира нищо. Обичайният debounce с изпълнение в края на поредицата изчаква пауза в извикванията; throttle може да продължи да изпълнява функцията и без пауза.
Подай положителен краен интервал и функция now, която връща крайни, ненамаляващи времеви стойности в милисекунди. Примерът използва симулиран часовник; в браузър можеш да подадеш () => performance.now(). Това е API на уеб платформата, затова провери наличността му в целевата среда за изпълнение. Ако друг вариант използва setTimeout(), обратното му извикване може да се изпълни по-късно от планираното.
Примери
{
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");
}Резултат
Update: A Update: C
A се изпълнява при 0 ms, B се пропуска при 40 ms, C се изпълнява точно на границата от 100 ms, а D се пропуска при 140 ms и не се изпълнява по-късно.
Свързани уроци
- JavaScript · Урок 21 · Начално · Версия: 4