Что такое…

Что такое debounce — и почему поле поиска шлёт шесть запросов вместо одного

Иллюстрация: шесть нажатий на клавиши сливаются в один запрос

Ты набираешь в поиске слово «москва». Шесть букв. Сколько запросов уходит на сервер?

Шесть. По одному на каждую букву — потому что событие input срабатывает на каждое нажатие. И пять из них уже никому не нужны: пользователь всё равно допечатал до конца.

Пока это база — просто лишняя нагрузка. А если под поиском стоит ИИ-подсказка, ты только что оплатил шесть обращений к модели вместо одного. За одно слово.

Лечится это одной техникой на пять строк.

Что такое debounce

Debounce (произносится «дибаунс», по-русски иногда «устранение дребезга») — это правило: не делай ничего, пока события не прекратятся.

Каждое новое нажатие не запускает запрос, а отменяет предыдущий отложенный и ставит новый. Запрос уйдёт только тогда, когда человек замолчал на 300 миллисекунд.

Аналогия — дверь лифта. Она не закрывается по таймеру от первого человека: каждый входящий сбрасывает отсчёт. Едем, когда поток иссяк.

Слово пришло из электроники: механическая кнопка при нажатии «дребезжит» — контакт замыкается и размыкается несколько раз за миллисекунды. Схема, которая ждёт, пока дребезг утихнет, и называется debouncer. С клавиатурой ровно то же: печатает человек быстро, а «намерение» у него одно.

Как это выглядит в коде

Весь механизм — переменная с таймером и clearTimeout:

let timer;

input.addEventListener('input', (e) => {
  clearTimeout(timer);                     // отменяем прошлый план
  const q = e.target.value;
  timer = setTimeout(() => search(q), 300); // ставим новый
});

Шесть букв — шесть clearTimeout и один search. Всё.

Единственное, что здесь легко испортить: сохраняй значение в переменную до setTimeout, как в примере. Если внутри таймера читать e.target.value заново, можно поймать уже другое состояние поля.

debounce или throttle — это не одно и то же

Их путают чаще всего, а ведут они себя противоположно.

debounce — «дождись тишины». Пока события идут, не делает ничего. Сработает один раз, в конце. Если человек печатает без остановки минуту — минуту не будет ни одного запроса.

throttle — «не чаще, чем». Пропускает событие, потом глушит всё на 300 мс, потом снова пропускает. Работает регулярно во время потока.

Отсюда правило выбора:

  • Важен только итог — debounce. Поиск по мере ввода, автосохранение черновика, валидация поля.
  • Важен процесс — throttle. Позиция скролла, перетаскивание элемента, счётчик прогресса.

Поставь throttle на поиск — получишь запрос каждые 300 мс во время печати, то есть половину проблемы обратно. Поставь debounce на скролл — «липкая» шапка появится, только когда пользователь остановится. Оба варианта выглядят как баг.

Главная ловушка: ответы приходят не по порядку

Вот причина брать debounce, о которой почти не пишут. Это не только про экономию — это про правильный результат.

Представь, что запросы всё-таки ушли: сначала «мос», потом «москва». Ответ на «москва» пришёл за 80 мс, а на «мос» — за 400. Что увидит пользователь?

Результаты по «мос». Потому что они пришли позже и перезаписали правильные.

Это классическая гонка, и она невоспроизводима на твоём быстром интернете — а у пользователя в метро всплывает регулярно. Debounce убирает почти все такие ситуации просто потому, что запрос остаётся один. А чтобы закрыть остаток, отменяй устаревший запрос честно:

let controller;

async function search(q) {
  controller?.abort();                 // рубим предыдущий
  controller = new AbortController();
  const res = await fetch(`/api/search?q=${q}`, { signal: controller.signal });
  render(await res.json());
}

AbortController — штатный способ прервать fetch. Без него старый ответ всё равно дойдёт и всё испортит. Если тема асинхронности пока туманная, начни с разбора про асинхронность.

Сколько ставить — и что это даёт

Про 300 мс: это не магия, а компромисс. Средний интервал между нажатиями при обычной печати — около 150–200 мс, так что 300 надёжно «переживает» паузу между буквами и при этом не ощущается как лаг.

Ориентиры на практике:

  • 150–250 мс — живой поиск, где важна отзывчивость.
  • 300–500 мс — если за полем стоит запрос к ИИ или тяжёлый расчёт.
  • 1000 мс и больше — автосохранение. Тут спешить некуда.

Выигрыш считается легко. Поисковая строка, 20 символов ввода, 100 пользователей в день: без debounce — 2000 запросов, с ним — около 100. Если каждый запрос идёт к модели, разница в двадцать раз ложится прямо в счёт — рядом с другими приёмами из разбора как сократить расходы на ИИ.

И да, debounce на клиенте не заменяет лимит частоты на сервере: первый экономит запросы вежливого пользователя, второй защищает от невежливого. А как устроен сам поиск по мере ввода — в гайде как добавить поиск в приложение.

Debounce нужен только для поиска?

Нет. Любое событие, которое летит пачками: resize окна, scroll, автосохранение при печати, пересчёт корзины при изменении количества, проверка «занят ли этот логин». Признак один — событий много, а нужен только последний результат.

Можно взять готовую функцию вместо своей?

Да, debounce есть в lodash и в десятке мелких пакетов. Но своя версия — это пять строк выше, и написать её раз полезно: тогда ты понимаешь, почему в React её нужно оборачивать в useMemo или useRef, иначе на каждом рендере создаётся новый таймер и debounce молча перестаёт работать.

Такие мелочи и отличают приложение, которое «вроде работает», от приложения, которое работает. В KODiQ мы разбираем их на «ты», по шагам и с живыми примерами.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →