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: Diese Funktion ist in Web Workers verfügbar.

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

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
dispatchEvent

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch