W3cubDocs

/Web APIs

DOMException: DOMException() constructor

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

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

	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