DOMException: DOMException() constructor

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

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 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

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

BCD tables only load in the browser

See also