Что такое 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 коротких урока на телефоне.





