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 July 2015.
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
dispatchEvent(event)
Parameter
event
-
Das zu versendende
Event
-Objekt. SeineEvent.target
-Eigenschaft wird auf das aktuelleEventTarget
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
Spezifikationen
Specification |
---|
DOM Standard # ref-for-dom-eventtarget-dispatchevent③ |
Browser-Kompatibilität
BCD tables only load in the browser