re:re:actable
Урок 153 минуты чтения

debounce и throttle

На этой странице
Кратко

Debounce откладывает вызов функции, пока события не прекратятся на заданное время: при наборе текста запрос уйдет только через 300 мс после последнего нажатия. Throttle ограничивает частоту: функция вызывается не чаще одного раза за интервал, даже если события идут непрерывно — например, обработчик прокрутки раз в 100 мс. Оба приема защищают от лишних вызовов при частых событиях.

Вопрос

Что делают debounce и throttle? Чем они отличаются, где применяются и как их реализовать?

Debounce

function debounce(fn, delay) {
  let timerId;
  return function (...args) {
    clearTimeout(timerId);
    timerId = setTimeout(() => fn.apply(this, args), delay);
  };
}
 
const search = debounce((query) => {
  fetch(`/api/search?q=${encodeURIComponent(query)}`);
}, 300);
 
input.addEventListener("input", (event) => search(event.target.value));
события: x x x x x       x x
вызовы:            ✔          ✔   (через delay после последнего события)

Варианты: trailing (вызов в конце паузы, по умолчанию) и leading (вызов сразу, затем игнорирование до паузы).

Throttle

function throttle(fn, interval) {
  let lastCall = 0;
  let timerId;
  return function (...args) {
    const now = Date.now();
    const remaining = interval - (now - lastCall);
    if (remaining <= 0) {
      lastCall = now;
      fn.apply(this, args);
    } else {
      clearTimeout(timerId);
      timerId = setTimeout(() => {   // гарантированный последний вызов
        lastCall = Date.now();
        fn.apply(this, args);
      }, remaining);
    }
  };
}
 
window.addEventListener("scroll", throttle(updateProgressBar, 100), { passive: true });
события: x x x x x x x x x x x
вызовы:  ✔     ✔     ✔     ✔      (не чаще раза в interval)

Сравнение

DebounceThrottle
Когда вызываетпосле паузы в событияхрегулярно, не чаще интервала
При непрерывных событияхможет не вызвать ни разу до остановкивызывает периодически
Применениепоиск, автосохранение, валидация, resize-перерасчетscroll, mousemove, drag, прогресс, бесконечная лента

Где применяются при запросах

  • поиск и автодополнение — debounce, чтобы не отправлять запрос на каждую букву;
  • автосохранение черновика — debounce;
  • подгрузка ленты при прокрутке — throttle или IntersectionObserver;
  • защита кнопки от двойного клика — блокировка кнопки или leading debounce.

Даже с debounce ответы могут прийти не по порядку — отменяйте предыдущий запрос через AbortController.

React

function SearchBox() {
  const [query, setQuery] = useState("");
  const debouncedQuery = useDebouncedValue(query, 300);
 
  useEffect(() => {
    if (!debouncedQuery) return;
    const controller = new AbortController();
    fetch(`/api/search?q=${debouncedQuery}`, { signal: controller.signal });
    return () => controller.abort();
  }, [debouncedQuery]);
 
  return <input value={query} onChange={(e) => setQuery(e.target.value)} />;
}
 
function useDebouncedValue(value, delay) {
  const [debounced, setDebounced] = useState(value);
  useEffect(() => {
    const id = setTimeout(() => setDebounced(value), delay);
    return () => clearTimeout(id);
  }, [value, delay]);
  return debounced;
}

Если создавать debounce-функцию прямо в теле компонента, она пересоздается при каждом рендере и перестает работать — оборачивайте в useMemo/useRef или используйте debounced value.

Что важно помнить

  • Реализации из lodash (debounce, throttle) поддерживают leading, trailing, maxWait и метод cancel.
  • Для анимаций и измерений при прокрутке лучше requestAnimationFrame — естественный throttle по кадрам.
  • useDeferredValue в React — альтернатива debounce для тяжелого рендера (без задержки по времени).
  • Не забывайте отменять отложенный вызов при размонтировании.

Мини-шпаргалка

  • Debounce — после паузы; throttle — не чаще интервала.
  • Debounce: поиск, автосохранение. Throttle: scroll, mousemove.
  • Реализация на setTimeout и замыкании.
  • В React — debounced value или useMemo для функции.
  • Ответы запросов — отменяйте через AbortController.

Документация

MDN: Debounce, MDN: Throttle, learn.javascript.ru: Декораторы debounce и throttle, lodash: debounce.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам