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 initCustomEvent, sind veraltet. Verwenden Sie stattdessen Event-Konstruktoren.

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

Syntax

js
createEvent(type)

Parameter

type

Ein String, der den Typ des zu erstellenden Events darstellt. Mögliche Event-Typen 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

Event-Typ-Strings, die für createEvent() geeignet sind, sind im DOM-Standard — siehe die Tabelle in Schritt 2 aufgeführt. Beachten Sie, dass die meisten Event-Objekte jetzt Konstruktoren haben, die der moderne empfohlene Weg zur Erstellung von Event-Objektinstanzen sind.

Spezifikationen

Specification
DOM
# dom-document-createevent

Browser-Kompatibilität

Siehe auch