DOMException()

The DOMException() constructor returns a DOMException object with a specified message and name.

Syntax

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 DOMString. If the specified name is a standard error name, then getting the code property of the DOMException 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

<button>Trigger DOM Exception</button>

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

JavaScript

const button = document.querySelector('button');

button.onclick = function() {
    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

Name	Web APIs
Version
Badge
Last Updated	2022-04-27T09:33:08Z