The DOMException()
constructor returns a DOMException
object with a specified message and name.
On this page
DOMException: DOMException() constructor
Syntax
js
new DOMException()
new DOMException(message)
new DOMException(message, name)
Parameters
message
Optional-
A description of the exception. If not present, the empty string
''
is used. name
Optional-
A string. If the specified name is a standard error name, then getting the
code
property of theDOMException
object will return the code number corresponding to the specified name.
Return value
A newly created DOMException
object.
Examples
In this example, pressing the button causes a custom DOMException
to be thrown, which is then caught and the custom error message shown in an alert.
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}`;
}
};
Result
Specifications
Specification |
---|
Web IDL Standard # dom-domexception-domexception |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
DOMException |
46 | 79 | 37 | No | 33 | 10.1 | 46 | 46 | 37 | 33 | 10.3 | 5.0 |
See also
- A polyfill of
DOMException
constructor is available incore-js
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMException/DOMException