preventDefault и отмена отправки формы
На этой странице
event.preventDefault() отменяет действие браузера по умолчанию: переход по ссылке, отправку формы с перезагрузкой страницы, отметку чекбокса, контекстное меню, прокрутку колесом. Событие при этом продолжает всплывать. Чтобы отправить форму через fetch, обработчик вешают на событие submit формы и вызывают preventDefault().
Вопрос
Что делает event.preventDefault()? Как отменить отправку формы и чем preventDefault отличается от stopPropagation?
Действия по умолчанию
| Событие | Действие браузера |
|---|---|
click на <a href> | переход по ссылке |
submit формы | отправка и перезагрузка страницы |
click на checkbox | переключение состояния |
keydown в поле | ввод символа |
contextmenu | контекстное меню |
wheel / touchmove | прокрутка |
dragover | запрет drop (нужен preventDefault, чтобы разрешить) |
Отмена отправки формы
<form id="login">
<input name="email" type="email" required>
<input name="password" type="password" required>
<button type="submit">Войти</button>
</form>const form = document.querySelector("#login");
form.addEventListener("submit", async (event) => {
event.preventDefault(); // без этого страница перезагрузится
const data = new FormData(form);
const response = await fetch("/api/login", { method: "POST", body: data });
if (!response.ok) showError("Неверный логин или пароль");
});Почему submit, а не click на кнопке:
- форма отправляется и по Enter в поле;
- встроенная валидация (
required,type="email") срабатывает передsubmit; - семантика и доступность сохраняются.
event.submitter показывает, какая кнопка отправила форму.
preventDefault и stopPropagation
link.addEventListener("click", (event) => {
event.preventDefault(); // не переходить по ссылке
// событие всё равно всплывет к родителям
});preventDefault() | stopPropagation() | |
|---|---|---|
| Отменяет | действие браузера | распространение события |
| Событие всплывает | да | нет |
| Обработчики выше | сработают | не сработают |
return false в обработчике onclick = preventDefault(); в addEventListener он ничего не делает.
Пассивные обработчики
window.addEventListener("wheel", (e) => e.preventDefault(), { passive: true });
// preventDefault игнорируется, в консоли предупреждениеБраузер по умолчанию делает touchstart, touchmove и wheel на window/document пассивными, чтобы скролл был плавным. Если отменять прокрутку действительно нужно — { passive: false }.
Проверка
event.cancelable; // можно ли отменить действие
event.defaultPrevented; // было ли оно отмененоФорма: reset
form.reset(); // вернуть начальные значения полей (атрибуты value, checked)
form.requestSubmit(); // отправить с валидацией и событием submit
form.submit(); // отправить БЕЗ валидации и без события submitЧто важно помнить
- В React
onSubmit={(e) => { e.preventDefault(); ... }}— тот же прием; Server Actions в React 19 и Next.js отправляют форму без ручногоpreventDefault. - Отмена
clickна ссылке не отменяет навигацию по среднему клику (событиеauxclick). - Не отменяйте поведение браузера без замены: ссылка, которая не переходит, — плохой UX и доступность.
- После
awaitвызыватьpreventDefaultпоздно — действие уже выполнено.
Мини-шпаргалка
preventDefault()— отменить действие браузера.- Форма — слушать
submitи вызватьpreventDefault(). - Событие продолжает всплывать.
passive: trueзапрещаетpreventDefaultради плавного скролла.form.reset(),form.requestSubmit().
Документация
MDN: preventDefault(), MDN: submit event, learn.javascript.ru: Действия браузера по умолчанию.