DOMExceptions are thrown when one of the DOM implementation classes discovers an error condition. The architecture is defined in terms of the ExceptionCode, but in the standard Java API this has been extended so the exception may also carry a text string. Standard exception codes are:
- INDEX_SIZE_ERR: index or size is negative, or greater than the allowed value.
- WSTRING_SIZE_ERR: the specified range of text does not fit into the string representation used in this implementation. Only arises in implementations whose strings have a maximum-size limit. The DOM provides workarounds to support those languages, generally by having the DOM extract a managable substring on their behalf.
- HIERARCHY_REQUEST_ERR: user tried to insert a node somewhere it doesn't belong... such as adding a child to a Text node.
- WRONG_DOCUMENT_ERR: a node is used in a different document than the one that created it (that doesn't support it). Currently, the DOM doesn't promise that nodes can be moved from document to document even if they're both using the same underlying implementation. Level 2 of the DOM spec may address this.
- INVALID_NAME_ERR: an invalid name is specified.
- NO_DATA_ALLOWED_ERR: data is specified for a node which does not support data.
- NO_MODIFICATION_ALLOWED_ERR: an attempt is made to modify an object where modifications are not allowed.
- NOT_FOUND_ERR: an attempt was made to reference a node in a context where it does not exist.
- NOT_SUPPORTED_ERR: the implementation does not support the type of object requested.
- INUSE_ATTRIBUTE_ERR: an attempt is made to add an attribute object that is already in use elsewhere.
@version
@since PR-DOM-Level-1-19980818.