Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

EventTarget.dispatchEvent(): synchroniczne wysyłanie zdarzeń

dispatchEvent(event) synchronicznie wysyła zdarzenie do celu. Wynik logiczny informuje o anulowaniu, a nie o obecności słuchaczy.

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

target.dispatchEvent(event)

target.dispatchEvent(event) wysyła obiekt Event do EventTarget. Słuchacze są wywoływani synchronicznie; metoda nie czeka na zakończenie operacji asynchronicznych rozpoczętych przez słuchaczy. Zdarzenie ma isTrusted === false.

Wynik to false, gdy zdarzenie anulowano; w przeciwnym razie true. preventDefault() anuluje zdarzenie tylko przy cancelable: true i poza słuchaczem pasywnym. stopPropagation() nie oznacza anulowania.

W drzewie DOM obowiązują przechwytywanie i opcjonalne bąbelkowanie (bubbles). Samodzielny new EventTarget() nie ma rodzica. Wyjątki słuchaczy są raportowane, ale nie propagują się do wywołującego. Ponowne wysłanie aktualnie wysyłanego obiektu powoduje InvalidStateError.

Przykład pokazuje kolejność synchroniczną i anulowanie. Kod aplikacji może wykorzystać wynik, aby zrezygnować z zapisu.

Przykłady

const target = new EventTarget();
const log = [];

target.addEventListener("save", (event) => {
  log.push("listener");
  event.preventDefault();
});

log.push("before");
const accepted = target.dispatchEvent(
  new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));

Wynik

before | listener | after: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła