EventTarget: Methode dispatchEvent()
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: Diese Funktion ist in Web Workers verfügbar.
Die dispatchEvent()-Methode von EventTarget sendet ein Event an das Objekt und ruft (synchron) die betroffenen Ereignislistener in der entsprechenden Reihenfolge auf. Die normalen Ereignisverarbeitungsregeln (einschließlich der Erfassungs- und optionalen Bubbling-Phase) gelten auch für Ereignisse, die manuell mit dispatchEvent() ausgelöst werden.
Der Aufruf von dispatchEvent() ist der letzte Schritt beim Auslösen eines Ereignisses. Das Ereignis sollte bereits mithilfe eines Event()-Konstruktors 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 zutreffenden Ereignishandler werden aufgerufen und geben zurück, bevor dispatchEvent() zurückkehrt.
Syntax
dispatchEvent(event)
Parameter
event-
Das zu versendende
Event-Objekt. SeineEvent.target-Eigenschaft wird auf das aktuelleEventTargetgesetzt.
Rückgabewert
false, wenn event abbruchfähig ist und mindestens einer der Ereignishandler, der event erhielt, Event.preventDefault() aufgerufen hat. Andernfalls true.
Ausnahmen
InvalidStateErrorDomException-
Wird ausgelöst, wenn der Typ des Ereignisses bei der Initialisierung des Ereignisses nicht angegeben wurde.
Warnung: Ausnahmen, die von Ereignishandlern ausgelöst werden, werden als nicht abgefangene Ausnahmen gemeldet. Die Ereignishandler laufen auf einem verschachtelten Aufrufstapel; sie blockieren den Aufrufer, bis sie abgeschlossen sind, aber Ausnahmen werden nicht an den Aufrufer weitergegeben.
Beispiel
Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-eventtarget-dispatchevent③ |