23/10/2021 16:37 DOM - DOMException Object
DOM - DOMException Object
The DOMException represents an abnormal event happening when a method or a property is
used.
Properties
Below table lists the properties of the DOMException object
S.No. Property & Description
name
1 Returns a DOMString that contains one of the string associated with an error
constant (as seen the table below).
Error Types
https://www.tutorialspoint.com/dom/dom_domexception_object.htm 1/5
23/10/2021 16:37 DOM - DOMException Object
S.No. Type & Description
IndexSizeError
1 The 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)
HierarchyRequestError
2 The node tree hierarchy is not correct. (Legacy code value: 3 and legacy constant
name: HIERARCHY_REQUEST_ERR)
WrongDocumentError
3 The object is in the wrong document. (Legacy code value: 4 and legacy constant
name: WRONG_DOCUMENT_ERR)
InvalidCharacterError
4 The string contains invalid characters. (Legacy code value: 5 and legacy constant
name: INVALID_CHARACTER_ERR)
NoModificationAllowedError
5 The object cannot be modified. (Legacy code value: 7 and legacy constant name:
NO_MODIFICATION_ALLOWED_ERR)
NotFoundError
6 The object cannot be found here. (Legacy code value: 8 and legacy constant name:
NOT_FOUND_ERR)
NotSupportedError
7 The operation is not supported. (Legacy code value: 9 and legacy constant name:
NOT_SUPPORTED_ERR)
InvalidStateError
8 The object is in an invalid state. (Legacy code value: 11 and legacy constant name:
INVALID_STATE_ERR)
SyntaxError
9 The string did not match the expected pattern. (Legacy code value: 12 and legacy
constant name: SYNTAX_ERR)
https://www.tutorialspoint.com/dom/dom_domexception_object.htm 2/5
23/10/2021 16:37 DOM - DOMException Object
10 InvalidModificationError
The object cannot be modified in this way. (Legacy code value: 13 and legacy
constant name: INVALID_MODIFICATION_ERR)
NamespaceError
11 The operation is not allowed by Namespaces in XML. (Legacy code value: 14 and
legacy constant name: NAMESPACE_ERR)
InvalidAccessError
12 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
13 legacy constant name: TYPE_MISMATCH_ERR) This value is deprecated, the
JavaScript TypeError exception is now raised instead of a DOMException with this
value.
SecurityError
14 The operation is insecure. (Legacy code value: 18 and legacy constant name:
SECURITY_ERR)
NetworkError
15 A network error occurred. (Legacy code value: 19 and legacy constant name:
NETWORK_ERR)
AbortError
16 The operation was aborted. (Legacy code value: 20 and legacy constant name:
ABORT_ERR)
URLMismatchError
17 The given URL does not match another URL. (Legacy code value: 21 and legacy
constant name: URL_MISMATCH_ERR)
QuotaExceededError
18 The quota has been exceeded. (Legacy code value: 22 and legacy constant name:
QUOTA_EXCEEDED_ERR)
https://www.tutorialspoint.com/dom/dom_domexception_object.htm 3/5
23/10/2021 16:37 DOM - DOMException Object
19 TimeoutError
The operation timed out. (Legacy code value: 23 and legacy constant name:
TIMEOUT_ERR)
InvalidNodeTypeError
20 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
21 The object cannot be cloned. (Legacy code value: 25 and legacy constant name:
DATA_CLONE_ERR)
EncodingError
22 The encoding operation, being an encoding or a decoding one, failed (No legacy
code value and constant name).
NotReadableError
23
The input/output read operation failed (No legacy code value and constant name).
Example
Following example demonstrates how using a not well-formed XML document causes a
DOMException.
error.xml contents are as below −
<?xml version = "1.0" encoding = "UTF-8" standalone = "no" ?>
<Company id = "companyid">
<Employee category = "Technical" id = "firstelement" type = "text/html">
<FirstName>Tanmay</first>
<LastName>Patil</LastName>
<ContactNo>1234567890</ContactNo>
<Email>[email protected]</Email>
</Employee>
</Company>
Following example demonstrates the usage of the name attribute −
<html>
<head>
<script>
function loadXMLDoc(filename) {
if (window.XMLHttpRequest) {
xhttp = new XMLHttpRequest();
https://www.tutorialspoint.com/dom/dom_domexception_object.htm 4/5
23/10/2021 16:37 DOM - DOMException Object
} else // code for IE5 and IE6 {
xhttp = new ActiveXObject("Microsoft.XMLHTTP");
xhttp.open("GET",filename,false);
xhttp.send();
return xhttp.responseXML;
</script>
</head>
<body>
<script>
try {
xmlDoc = loadXMLDoc("/dom/error.xml");
var node = xmlDoc.getElementsByTagName("to").item(0);
var refnode = node.nextSibling;
var newnode = xmlDoc.createTextNode('That is why you fail.');
node.insertBefore(newnode, refnode);
} catch(err) {
document.write(err.name);
</script>
</body>
</html>
Execution
Save this file as domexcption_name.html on the server path (this file and error.xml should be on
the same path in your server). We will get the output as shown below −
TypeError
https://www.tutorialspoint.com/dom/dom_domexception_object.htm 5/5