Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła