The DOMException
exception represents an abnormal event happening when a method or a property is used.
Constructor
DOMException()
- Returns a
DOMException
object with a specified message and name.
Attributes
DOMException.code
Read only- Returns a
short
that contains one of the error code constants, or0
if none match. This field is used for historical reasons, new kind of DOM exceptions don't use anymore: they put this info in theDOMException.name
attribute. DOMException.name
Read only- Returns a
DOMString
that contains one of the string associated with an error constant.
Error codes
IndexSizeError
- The index is not in the allowed range. For example, this can be thrown by
Range
object. (Legacy code value:1
and legacy constant name:INDEX_SIZE_ERR
) HierarchyRequestError
- The node tree hierarchy is not correct. (Legacy code value:
3
and legacy constant name:HIERARCHY_REQUEST_ERR
) WrongDocumentError
- The object is in the wrong
Document
. (Legacy code value:4
and legacy constant name:WRONG_DOCUMENT_ERR
) InvalidCharacterError
- The string contains invalid characters. (Legacy code value:
5
and legacy constant name:INVALID_CHARACTER_ERR
) NoModificationAllowedError
- The object can not be modified. (Legacy code value:
7
and legacy constant name:NO_MODIFICATION_ALLOWED_ERR
) NotFoundError
- The object can not be found here. (Legacy code value:
8
and legacy constant name:NOT_FOUND_ERR
) NotSupportedError
- The operation is not supported. (Legacy code value:
9
and legacy constant name:NOT_SUPPORTED_ERR
) InvalidStateError
- The object is in an invalid state. (Legacy code value:
11
and legacy constant name:INVALID_STATE_ERR
) SyntaxError
- The string did not match the expected pattern. (Legacy code value:
12
and legacy constant name:SYNTAX_ERR
) InvalidModificationError
- The object can not be modified in this way. (Legacy code value:
13
and legacy constant name:INVALID_MODIFICATION_ERR
) NamespaceError
- The operation is not allowed by Namespaces in XML. (Legacy code value:
14
and legacy constant name:NAMESPACE_ERR
) InvalidAccessError
- The object does not support the operation or argument. (Legacy code value:
15
and legacy constant name:INVALID_ACCESS_ERR
) TypeMismatchError
- 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 JavaScriptTypeError
exception is now raised instead of aDOMException
with this value. SecurityError
- The operation is insecure. (Legacy code value:
18
and legacy constant name:SECURITY_ERR
) NetworkError
- A network error occurred. (Legacy code value:
19
and legacy constant name:NETWORK_ER
R
) AbortError
- The operation was aborted. (Legacy code value:
20
and legacy constant name:ABORT_ERR
) URLMismatchError
- The given URL does not match another URL. (Legacy code value:
21
and legacy constant name:URL_MISMATCH_ERR
) QuotaExceededError
- The quota has been exceeded. (Legacy code value:
22
and legacy constant name:QUOTA_EXCEEDED_ERR
) TimeoutError
- The operation timed out. (Legacy code value:
23
and legacy constant name:TIMEOUT_ERR
) InvalidNodeTypeError
- 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
- The object can not be cloned. (Legacy code value:
25
and legacy constant name:DATA_CLONE_ERR
) EncodingError
- The encoding operation, being an encoding or a decoding one, failed (No legacy code value and constant name).
NotReadableError
- The input/output read operation failed (No legacy code value and constant name).
Specifications
Specification | Status | Comment |
---|---|---|
Web IDL (Second Edition) The definition of 'constructor' in that specification. |
Candidate Recommendation | Adds the constructor for the DOMException class. Adds the NotReadableError value. |
DOM4 The definition of 'DOMException' in that specification. |
Working Draft | Added SECURITY_ERR , NETWORK_ERR , ABORT_ERR , URL_MISMATCH_ERR , QUOTA_EXCEEDED_ERR , TIMEOUT_ERR , INVALID_NODE_TYPE_ERR , and DATA_CLONE_ERR . The property code has been deprecated for exception values. The EncodingError value added. |
Document Object Model (DOM) Level 3 Core Specification The definition of 'DOMException' in that specification. |
Recommendation | Added of VALIDATION_ERR and TYPE_MISMATCH_ERR . |
Document Object Model (DOM) Level 2 Core Specification The definition of 'DOMException' in that specification. |
Recommendation | Added of INVALID_STATE_ERR , SYNTAX_ERR , INVALID_MODIFICATION_ERR , NAMESPACE_ERR , and INVALID_ACCESS_ERR . |
Document Object Model (DOM) Level 1 Specification The definition of 'DOMException' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.7 or earlier) | ? | ? | ? |
DOM Level 4 support | (Yes) | 13.0 (13.0) | ? | ? | ? |
DATA_CLONE_ERR constant |
(Yes) | 5.0 (5.0) | ? | ? | ? |
Constructor | No support | ? | ? | ? | ? |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | ? | (Yes) | 1.0 (1.0) | ? | ? | ? | (Yes) |
DOM Level 4 support | ? | (Yes) | 13.0 (13.0) | ? | ? | ? | (Yes) |
DATA_CLONE_ERR constant |
? | (Yes) | 5.0 (5.0) | ? | ? | ? | (Yes) |
Constructor | No support | No support | ? | ? | ? | ? | No support |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
cvrebert,
fscholz,
Sheppy,
jpmedley,
teoli,
DomenicDenicola,
devinrhode2,
kscarfone,
user01,
Brettz9,
CHaoSlayeR
Last updated by:
cvrebert,