Почему событие срабатывает дважды — три причины и как починить каждую

Нажимаешь Enter — сообщение в чате уходит дважды. Кликаешь «лайк» — счётчик прыгает на два. Открываешь окно третий раз — и одна клавиша срабатывает уже трижды.
Хорошая новость: причин почти всегда три, и каждая проверяется за минуту. Начнём с самой частой.
Сначала два слова о том, как устроены события. Ты говоришь браузеру: «когда случится клик — вызови вот эту функцию». Это называется обработчик, или слушатель события. По сути это колбэк: ты его не вызываешь сам, его вызывает браузер. И если браузер зовёт его дважды — значит, где-то его записали дважды или событие дошло до двух адресатов.
Причина 1. React в режиме разработки (самая частая)
Если у тебя React и обработчик вешается в useEffect, начни отсюда. В режиме разработки React специально запускает эффекты два раза: включает, выключает и включает снова. Так он проверяет, умеешь ли ты за собой убирать.
Вот код, который ИИ пишет постоянно:
useEffect(() => {
window.addEventListener("keydown", (e) => {
if (e.key === "Enter") send()
})
}, [])
Эффект запустился дважды — и каждый раз создал новую стрелку. Для браузера это два разных обработчика, и он повесил оба. А снять их код не умеет.
Как проверить. Собери и запусти прод-версию (npm run build, потом npm run preview или npm start). Если там всё срабатывает один раз, а на npm run dev — дважды, это оно.
Как починить. Эффект должен возвращать функцию уборки — она снимает обработчик:
useEffect(() => {
const onKey = (e) => {
if (e.key === "Enter") send()
}
window.addEventListener("keydown", onKey)
return () => window.removeEventListener("keydown", onKey)
}, [])
Не отключай строгий режим, чтобы «ушло». Он не ломает приложение — он показывает, что без уборки обработчики будут копиться и в проде, например при переходах между страницами.
Причина 2. Обработчик вешается снова и снова
Главный признак: число срабатываний растёт. Первый раз — одно, после повторного открытия — два, потом три.
Обычно это addEventListener внутри функции, которая вызывается многократно:
function openModal() {
modal.classList.add("open")
document.addEventListener("keydown", (e) => { // при каждом открытии
if (e.key === "Escape") closeModal()
})
}
Тут тонкость. Если добавить ту же самую функцию второй раз, браузер её не задублирует. Но стрелка, написанная прямо внутри, при каждом вызове рождается заново. Для браузера это новый слушатель — и он добавит ещё одного.
Как проверить. Поставь console.log первой строкой обработчика и открой окно несколько раз. Смотри в логи: одна строка на нажатие — норма. Растущая пачка — это оно.
Как починить. Три варианта, от простого к надёжному:
- повесь обработчик один раз при загрузке страницы, а не при каждом открытии;
- если он нужен на одно срабатывание — добавь опцию
{ once: true }, и браузер сам его снимет; - снимай его при закрытии через
removeEventListener.
Ловушка при снятии: передай ту же самую функцию, что и при добавлении. Если вешал анонимную стрелку () => close(), снять её не получится — у тебя нет на неё ссылки. removeEventListener молча ничего не сделает. Поэтому обработчик сначала клади в переменную, а потом добавляй и снимай по имени.
Причина 3. Событие «всплыло» к родителю
Бывает, что обработчики разные, а клик один. Кнопка «удалить» лежит внутри карточки. У кнопки свой onClick — удалить. У карточки свой — открыть. Нажимаешь «удалить» — и товар удаляется, и карточка открывается.
Это не баг браузера, а его обычное поведение. Событие начинается на кнопке и поднимается вверх по DOM через всех родителей. Каждый, у кого есть обработчик на это событие, его получит.
Как проверить. Посмотри, есть ли обработчик на том же событии у контейнера вокруг: карточки, строки таблицы, формы.
Как починить. В обработчике кнопки останови подъём:
function onDelete(event) {
event.stopPropagation()
deleteItem(id)
}
Частный случай — формы. Кнопка внутри <form> по умолчанию отправляет форму. Если у кнопки есть onClick с отправкой, а у формы onSubmit — отправка уйдёт дважды. Оставь логику в одном месте: в onSubmit формы.
Промпт, который чинит с первого раза
кнопка срабатывает два раза, починиОбработчик keydown срабатывает дважды, в dev-режиме React. Проверь: 1) есть ли у useEffect с addEventListener функция уборки с removeEventListener; 2) не вешается ли обработчик повторно при каждом открытии окна; 3) не ловит ли то же событие родительский элемент. Для снятия используй ту же функцию, что и для добавления.Почему запрос к серверу уходит два раза только на localhost?
Та же причина 1: строгий режим React дважды запускает эффекты в разработке. В проде запрос уйдёт один раз, но эффект всё равно стоит научить отменять лишний запрос.
Помогает ли просто поставить флаг «уже нажато»?
Как временная заплатка — да. Но флаг прячет симптом, а обработчики продолжают копиться. Найди, где их вешают лишний раз, — это надёжнее.
Что если это двойной клик пользователя?
Тогда события честно два. Защищайся блокировкой кнопки на время запроса: disabled, пока ждёшь ответа. Так заодно не будет двух заказов вместо одного.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





