DOMException: DOMException()-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: Dieses Feature ist verfügbar in Web Workers.

Der DOMException()-Konstruktor gibt ein DOMException-Objekt mit einer angegebenen Nachricht und einem Namen zurück.

Syntax

js
new DOMException()
new DOMException(message)
new DOMException(message, name)

Parameter

message Optional

Eine Beschreibung der Ausnahme. Wenn nicht vorhanden, wird der leere String '' verwendet.

name Optional

Ein String. Wenn der angegebene Name ein standardmäßiger Fehlername ist, dann gibt das Abrufen der code-Eigenschaft des DOMException-Objekts die Codenummer zurück, die dem angegebenen Namen entspricht. Wenn nicht vorhanden, wird der String 'Error' verwendet.

Rückgabewert

Ein neu erstelltes DOMException-Objekt.

Beispiele

In diesem Beispiel führt das Drücken des Buttons dazu, dass eine benutzerdefinierte DOMException ausgelöst wird, die dann abgefangen und die benutzerdefinierte Fehlermeldung in einem Alert angezeigt wird.

HTML

html
<button>Trigger DOM Exception</button>

<p id="output"></p>

JavaScript

js
const button = document.querySelector("button");

button.onclick = () => {
  try {
    throw new DOMException("Custom DOM Exception Triggered.");
  } catch (error) {
    document.querySelector("#output").textContent = `Error: ${error.message}`;
  }
};

Ergebnis

Spezifikationen

Specification
Web IDL Standard
# dom-domexception-domexception

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch