/Web APIs

DOMException: DOMException() constructor

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


new DOMException()
new DOMException(message)
new DOMException(message, name)


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.


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.


<button>Trigger DOM Exception</button>

<p id="output"></p>


const button = document.querySelector("button");

button.onclick = () => {
  try {
    throw new DOMException("Custom DOM Exception Triggered.");
  } catch (error) {
    document.querySelector("#output").textContent = `Error: ${error.message}`;



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

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.