Document: createEvent() Methode

Warnung: Viele Methoden, die mit createEvent verwendet werden, wie initCustomEvent, sind veraltet. Verwenden Sie stattdessen Event-Konstruktoren.

Erstellt ein Ereignis des angegebenen Typs. Das zurückgegebene Objekt sollte zunächst initialisiert und kann dann an EventTarget.dispatchEvent übergeben werden.

Syntax

js
createEvent(type)

Parameter

type

Ein String, der den Typ des zu erstellenden Ereignisses darstellt. Mögliche Ereignistypen sind "UIEvents", "MouseEvents", "MutationEvents" und "HTMLEvents". Siehe den Abschnitt Anmerkungen für Details.

Rückgabewert

Ein Event Objekt.

Beispiele

js
// Create the event.
const event = document.createEvent("Event");

// Define that the event name is 'build'.
event.initEvent("build", true, true);

// Listen for the event.
elem.addEventListener(
  "build",
  (e) => {
    // e.target matches elem
  },
  false,
);

// Target can be any Element or other EventTarget.
elem.dispatchEvent(event);

Anmerkungen

Ereignistyp-Strings, die für die Übergabe an createEvent() geeignet sind, sind im DOM-Standard — siehe die Tabelle in Schritt 2 aufgeführt. Beachten Sie, dass die meisten Ereignisobjekte inzwischen Konstruktoren haben, die der moderne empfohlene Weg zur Erstellung von Ereignisobjektinstanzen sind.

Spezifikationen

Specification
DOM Standard
# dom-document-createevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch