Гайды

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

Иллюстрация: палец жмёт на звонок один раз, а бьют по нему два молоточка

Нажимаешь 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 коротких урока на телефоне.

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

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

Все статьи →