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 theDOMExceptionobject 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
DOMExceptionconstructor](https://core-js.io/docs/features/web-standards/dom-exception) is available in [core-js](https://core-js.io/)