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 Januar 2020.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Der DOMException()-Konstruktor gibt ein
DOMException-Objekt mit einer angegebenen Nachricht und einem Namen zurück.
Syntax
new DOMException()
new DOMException(message)
new DOMException(message, name)
Parameter
messageOptional-
Eine Beschreibung der Ausnahme. Wenn nicht vorhanden, wird der leere String
''verwendet. nameOptional-
Ein String. Wenn der angegebene Name ein standardmäßiger Fehlername ist, dann gibt das Abrufen der
code-Eigenschaft desDOMException-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
<button>Trigger DOM Exception</button>
<p id="output"></p>
JavaScript
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 # dom-domexception-domexception |
Browser-Kompatibilität
Siehe auch
- Ein Polyfill des
DOMException-Konstruktors ist incore-jsverfügbar.