CKTIS / JavaScript
EventTarget.dispatchEvent(): synchrone Ereignisverteilung
dispatchEvent(event) verteilt ein Ereignis synchron an ein Ziel. Der boolesche Rückgabewert zeigt an, ob das Ereignis abgebrochen wurde, nicht ob Listener vorhanden sind.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
target.dispatchEvent(event)target.dispatchEvent(event) verteilt ein Event-Objekt an ein EventTarget. Listener werden synchron aufgerufen; die Methode wartet nicht auf asynchrone Arbeit, die Listener starten. Für das Ereignis gilt isTrusted === false.
Das Ergebnis ist false, wenn das Ereignis abgebrochen wurde, andernfalls true. preventDefault() bricht das Ereignis nur bei cancelable: true und außerhalb eines passiven Listeners ab. stopPropagation() bedeutet nicht, dass das Ereignis abgebrochen wird.
In einem DOM-Baum gelten die Erfassungsphase und optionales Bubbling (bubbles). Ein eigenständiges new EventTarget() hat kein übergeordnetes Element. Ausnahmen von Listenern werden gemeldet, aber nicht an den Aufrufer weitergegeben. Wird das gerade verteilte Objekt erneut verteilt, führt das zu InvalidStateError.
Das Beispiel veranschaulicht die synchrone Reihenfolge und den Abbruch. Anwendungscode kann das Ergebnis nutzen, um das Speichern zu überspringen.
Beispiele
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(" | "));Ergebnis
before | listener | after: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.