The DOMException interface represents an abnormal event (called an exception) that occurs as a result of calling a method or accessing a property of a web API. This is how error conditions are described in web APIs.
Each exception has a name, which is a short "PascalCase"-style string identifying the error or abnormal condition.
DOMException is a Serializable object, so it can be cloned with structuredClone() or copied between Workers using postMessage().
DOMException()Returns a DOMException object with a specified message and name.
DOMException.code Deprecated Read only
Returns one of the legacy error code constants, or 0 if none match.
DOMException.message Read only
Returns a string representing a message or description associated with the given error name.
DOMException.name Read only
Returns a string that contains one of the strings associated with an error name.
Common error names are listed here. Some APIs define their own sets of names, so this is not necessarily a complete list.
Note that the following deprecated historical errors don't have an error name but instead have only a legacy constant code value and a legacy constant name:
2, legacy constant name: DOMSTRING_SIZE_ERR
6, legacy constant name: NO_DATA_ALLOWED_ERR
16, legacy constant name: VALIDATION_ERR
Note: Because historically the errors were identified by a numeric value that corresponded with a named variable defined to have that value, some of the entries below indicate the legacy code value and constant name that were used in the past.
IndexSizeErrorThe index is not in the allowed range. For example, this can be thrown by the Range object. (Legacy code value: 1 and legacy constant name: INDEX_SIZE_ERR)
HierarchyRequestErrorThe node tree hierarchy is not correct. (Legacy code value: 3 and legacy constant name: HIERARCHY_REQUEST_ERR)
WrongDocumentErrorThe object is in the wrong Document. (Legacy code value: 4 and legacy constant name: WRONG_DOCUMENT_ERR)
InvalidCharacterErrorThe string contains invalid characters. (Legacy code value: 5 and legacy constant name: INVALID_CHARACTER_ERR)
NoModificationAllowedErrorThe object cannot be modified. (Legacy code value: 7 and legacy constant name: NO_MODIFICATION_ALLOWED_ERR)
NotFoundErrorThe object cannot be found here. (Legacy code value: 8 and legacy constant name: NOT_FOUND_ERR)
NotSupportedErrorThe operation is not supported. (Legacy code value: 9 and legacy constant name: NOT_SUPPORTED_ERR)
InvalidStateErrorThe object is in an invalid state. (Legacy code value: 11 and legacy constant name: INVALID_STATE_ERR)
InUseAttributeErrorThe attribute is in use. (Legacy code value: 10 and legacy constant name: INUSE_ATTRIBUTE_ERR)
SyntaxErrorThe string did not match the expected pattern. (Legacy code value: 12 and legacy constant name: SYNTAX_ERR)
InvalidModificationErrorThe object cannot be modified in this way. (Legacy code value: 13 and legacy constant name: INVALID_MODIFICATION_ERR)
NamespaceErrorThe operation is not allowed by Namespaces in XML. (Legacy code value: 14 and legacy constant name: NAMESPACE_ERR)
InvalidAccessErrorThe object does not support the operation or argument. (Legacy code value: 15 and legacy constant name: INVALID_ACCESS_ERR)
TypeMismatchError Deprecated
The type of the object does not match the expected type. (Legacy code value: 17 and legacy constant name: TYPE_MISMATCH_ERR) This value is deprecated; the JavaScript TypeError exception is now raised instead of a DOMException with this value.
SecurityErrorThe operation is insecure. (Legacy code value: 18 and legacy constant name: SECURITY_ERR)
NetworkError Experimental
A network error occurred. (Legacy code value: 19 and legacy constant name: NETWORK_ERR)
AbortError Experimental
The operation was aborted. (Legacy code value: 20 and legacy constant name: ABORT_ERR)
URLMismatchError Experimental
The given URL does not match another URL. (Legacy code value: 21 and legacy constant name: URL_MISMATCH_ERR)
QuotaExceededError Experimental
The quota has been exceeded. (Legacy code value: 22 and legacy constant name: QUOTA_EXCEEDED_ERR)
TimeoutErrorThe operation timed out. (Legacy code value: 23 and legacy constant name: TIMEOUT_ERR)
InvalidNodeTypeError Experimental
The node is incorrect or has an incorrect ancestor for this operation. (Legacy code value: 24 and legacy constant name: INVALID_NODE_TYPE_ERR)
DataCloneError Experimental
The object can not be cloned. (Legacy code value: 25 and legacy constant name: DATA_CLONE_ERR)
EncodingError Experimental
The encoding or decoding operation failed (No legacy code value and constant name).
NotReadableError Experimental
The input/output read operation failed (No legacy code value and constant name).
UnknownError Experimental
The operation failed for an unknown transient reason (e.g. out of memory) (No legacy code value and constant name).
ConstraintError Experimental
A mutation operation in a transaction failed because a constraint was not satisfied (No legacy code value and constant name).
DataError Experimental
Provided data is inadequate (No legacy code value and constant name).
TransactionInactiveError Experimental
A request was placed against a transaction that is currently not active or is finished (No legacy code value and constant name).
ReadOnlyError Experimental
The mutating operation was attempted in a "readonly" transaction (No legacy code value and constant name).
VersionError Experimental
An attempt was made to open a database using a lower version than the existing version (No legacy code value and constant name).
OperationError Experimental
The operation failed for an operation-specific reason (No legacy code value and constant name).
NotAllowedErrorThe request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission (No legacy code value and constant name).
| Specification |
|---|
| Web IDL Standard # idl-DOMException |
| 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 |
DOMException |
1 | 12 | 1 | 9 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
code |
1 | 12 | 1 | 9 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
message |
1 | 12 | 1 | 9 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
name |
1 | 12 | 1 | 10 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
serializable_object |
77 | 79 | 101 | No | 64 | No | 77 | 77 | 101 | 55 | No | 12.0 |
DOMException is available in core-js
DOMError
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMException