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 string. 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 = () => {
    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

BCD tables only load in the browser

See also