EventTarget: dispatchEvent()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die dispatchEvent()-Methode von EventTarget sendet ein Event an das Objekt und ruft dabei (synchron) die betroffenen Ereignislistener in der entsprechenden Reihenfolge auf. Die normalen Regeln der Ereignisverarbeitung (einschließlich der Capturing- und optionalen Bubbling-Phase) gelten auch für manuell mit dispatchEvent() ausgelöste Ereignisse.

Ein Aufruf von dispatchEvent() ist der letzte Schritt, um ein Ereignis zu lösen. Das Ereignis sollte bereits mit einem Event()-Konstruktor erstellt und initialisiert worden sein.

Hinweis: Beim Aufruf dieser Methode wird die Event.target-Eigenschaft auf das aktuelle EventTarget initialisiert.

Im Gegensatz zu "nativen" Ereignissen, die vom Browser ausgelöst werden und Ereignishandler asynchron über die Ereignisschleife aufrufen, ruft dispatchEvent() Ereignishandler synchron auf. Alle anwendbaren Ereignishandler werden aufgerufen und kehren zurück, bevor dispatchEvent() zurückkehrt.

Syntax

js
dispatchEvent(event)

Parameter

event

Das zu versendende Event-Objekt. Seine Event.target-Eigenschaft wird auf das aktuelle EventTarget gesetzt.

Rückgabewert

false, wenn das event abbrechbar ist und mindestens einer der Ereignishandler, der das event erhalten hat, Event.preventDefault() aufgerufen hat. Andernfalls true.

Ausnahmen

InvalidStateError DomException

Wird ausgelöst, wenn der Ereignistyp während der Ereignisinitialisierung nicht angegeben wurde.

Warnung: Von Ereignishandlern geworfene Ausnahmen werden als nicht abgefangene Ausnahmen gemeldet. Die Ereignishandler laufen in einem geschachtelten Aufrufstapel; sie blockieren den Anrufer, bis sie abgeschlossen sind, aber Ausnahmen propagieren nicht zum Anrufer.

Beispiel

Siehe Ereignisse erstellen und auslösen.

Spezifikationen

Specification
DOM Standard
# ref-for-dom-eventtarget-dispatchevent③

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch