EventTarget: Methode dispatchEvent()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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.

In diesem Artikel

Syntax

dispatchEvent(event)

Parameter

event

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

Rückgabewert

false, wenn event abbruchfähig ist und mindestens einer der Ereignishandler, der event erhielt, Event.preventDefault() aufgerufen hat. Andernfalls true.

Ausnahmen

InvalidStateError DomException

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.