DOMException: DOMException() constructor

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("DOM")}}{{AvailableInWorkers}}

The **DOMException()** constructor returns a {{domxref("DOMException")}} object with a specified message and name.

Syntax

js-nolint
new DOMException()
new DOMException(message)
new DOMException(message, name)

Parameters

  • message {{optional_inline}}
  • : A description of the exception. If not present, the empty string '' is used.
  • name {{optional_inline}}
  • : A string. If the specified name is a standard error name, then getting the [code](/en-US/docs/Web/API/DOMException/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 {{domxref("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

{{ EmbedLiveSample('Examples', '100%', 100) }}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • [A polyfill of DOMException constructor](https://core-js.io/docs/features/web-standards/dom-exception) is available in [core-js](https://core-js.io/)