CustomEvent: CustomEvent() 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: Diese Funktion ist in Web Workers verfügbar.

Der CustomEvent()-Konstruktor erstellt ein neues CustomEvent-Objekt.

Syntax

js
new CustomEvent(type)
new CustomEvent(type, options)

Parameter

type

Ein String, der den Namen des Ereignisses angibt. Ereignisnamen sind groß- und kleinschreibungsabhängig.

options Optional

Ein Objekt, das zusätzlich zu den in Event() definierten Eigenschaften die folgenden Eigenschaften haben kann:

detail Optional

Ein ereignisabhängiger Wert, der dem Ereignis zugeordnet ist. Dieser Wert ist dann für den Handler über die CustomEvent.detail-Eigenschaft verfügbar. Standardmäßig ist dieser Wert null.

Rückgabewert

Ein neues CustomEvent-Objekt.

Beispiel

js
// create custom events
const catFound = new CustomEvent("animalfound", {
  detail: {
    name: "cat",
  },
});
const dogFound = new CustomEvent("animalfound", {
  detail: {
    name: "dog",
  },
});

const element = document.createElement("div"); // create a <div> element

// add an appropriate event listener
element.addEventListener("animalfound", (e) => console.log(e.detail.name));

// dispatch the events
element.dispatchEvent(catFound);
element.dispatchEvent(dogFound);

// "cat" and "dog" logged in the console

Weitere Beispiele finden Sie unter Erstellen und Auslösen von Ereignissen.

Spezifikationen

Specification
DOM
# ref-for-dom-customevent-customevent

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
CustomEvent() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch