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.