CKTIS / JavaScript
Event.preventDefault() — anulowanie domyślnej czynności
preventDefault() oznacza zdarzenie jako anulowane, aby powstrzymać powiązaną czynność domyślną. Wymaga cancelable: true i nie działa w pasywnym nasłuchiwaczu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.preventDefault()event.preventDefault() sygnalizuje anulowanie powiązanej czynności, np. wysłania formularza. Zwraca undefined.
Wywołanie ustawia defaultPrevented na true, jeśli cancelable jest true i nasłuchiwacz nie jest pasywny. W przeciwnym razie nie zmienia stanu anulowania; samo sprawdzenie cancelable nie wystarcza w nasłuchiwaczu z passive: true.
Nie zatrzymuje propagacji ani innych nasłuchiwaczy. Do tego służą odpowiednio stopPropagation() i stopImmediatePropagation().
Przykład używa zdarzenia syntetycznego bez wbudowanej czynności domyślnej. Pokazuje stan anulowania: dispatchEvent() zwraca false, ponieważ zdarzenie zostało anulowane. To Web API z DOM Standard, nie funkcja definiowana przez ECMAScript.
Przykłady
const target = new EventTarget();
target.addEventListener("demo", (event) => {
event.preventDefault();
}, { passive: false });
const event = new Event("demo", { cancelable: true });
console.log(event.defaultPrevented);
console.log(target.dispatchEvent(event));
console.log(event.defaultPrevented);Wynik
false false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.