DOMException: DOMException() constructor

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

<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

Browser compatibility

See also

• A polyfill of DOMException constructor is available in core-js