XML DOM » Objects » DOMException
An exception is only raised
in such unusual circumstances as when an operation is impossible to
perform. This can happen for logical reasons, because data is lost or
because the implementation has become unstable. In ordinary processing
situations DOM methods generally return specific error values (e.g.
out-of-bound errors when using a NodeList).
Specific implementations may
raise other exceptions under other circumstances, such as passing a
null argument.
Some languages and object
systems do not support the concept of exceptions. In such cases error
conditions may be indicated using native error-reporting
mechanisms.
Error Types
Below is a list of the error type constants and the integers used to
represent them.
- INDEX_SIZE_ERR(1)
if index or size is negative, or greater than the allowed value - DOMSTRING_SIZE_ERR(2)
if the specified range of text does not fit into a DOMString - HIERARCHY_REQUEST_ERR(3)
if any node is inserted where is does not belong - WRONG_DOCUMENT_ERR(4)
if a node is used in a document other than the one that created it - INVALID_CHARACTER_ERR(5)
if an invalid character is specified, such as in a name - NO_DATA_ALLOWED_ERR(6)
if data is specified for a node that does not support data - NO_MODIFICATION_ALLOWED_ERR(7)
if an attempt is made to modify an object that does not allow modification - NOT_FOUND_ERR(8)
if an attempt is made to reference a node in a context in which it does not exist - NOT_SUPPORTED_ERR(9)
if the implementation does not support the type of object requested - INUSE_ATTRIBUTE_ERR(10)
if an attempt is made to add an attribute that is already in use elsewhere
