OBJECT:  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


Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information