Dokumentation: createEvent() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

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

Erstellt ein Ereignis des angegebenen Typs. Das zurückgegebene Objekt sollte zuerst initialisiert werden 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". Einzelheiten finden Sie im Abschnitt Hinweise.

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);

Hinweise

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

Spezifikationen

Specification
DOM Standard
# dom-document-createevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch