Event: Event()-Konstruktor

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.

Der Event()-Konstruktor erstellt ein neues Event-Objekt. Ein auf diese Weise erstelltes Ereignis wird als synthetisches Ereignis bezeichnet, im Gegensatz zu einem vom Browser ausgelösten Ereignis, und kann von einem Skript ausgelöst werden.

Syntax

js
new Event(type)
new Event(type, options)

Werte

type

Ein String mit dem Namen des Ereignisses.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

bubbles Optional

Ein boolescher Wert, der angibt, ob das Ereignis "bubbles". Der Standardwert ist false.

cancelable Optional

Ein boolescher Wert, der angibt, ob das Ereignis abgebrochen werden kann. Der Standardwert ist false.

composed Optional

Ein boolescher Wert, der angibt, ob das Ereignis Listener außerhalb eines Shadow Roots auslösen wird (siehe Event.composed für mehr Details). Der Standardwert ist false.

Rückgabewert

Ein neues Event-Objekt.

Beispiel

js
// create a look event that bubbles up and cannot be canceled

const evt = new Event("look", { bubbles: true, cancelable: false });
document.dispatchEvent(evt);

// event can be dispatched from any element, not only the document
myDiv.dispatchEvent(evt);

Spezifikationen

Specification
DOM Standard
# ref-for-dom-event-event

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch