DOMException: DOMException() constructor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers.

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. If not present, the string 'Error' is used.

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
# dom-domexception-domexception

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
DOMException() constructor

See also