Dokumentation: createEvent() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

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