DOMException()

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

Syntax

var domException = new DOMException();
var domException = new DOMException(message);
var domException = 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
WebIDL Level 1 (WebIDL 1)
# dom-domexception-domexception

Browser compatibility

BCD tables only load in the browser