Python & XML

Name

DOMException

Synopsis

DOM operations may occasionally encounter a problem and raise an exception. The abstract interface defined by the W3C DOM specification defines one exception and several constants. In this interface, specific exceptions are detected by catching the general exception and checking the code attribute of the exception object. Python extends this to behave more like other Python exceptions: there is the DOMException base class for the exceptions, and a derived class for each specific exception. The code attribute still takes one of the defined constants as a value. Code that is expecting to deal with only one particular exception should only name the specific derived exception in an except clause but code that expects to handle any DOM exception in a general way should name the DOMException base class. All of the exception classes and constants are defined in the xml.dom module.

In this list, the first name is the name of the exception class, and the second name is the name of the constant for the code attribute.

IndexSizeErr (INDEX_SIZE_ERR)

Raised if an index of size is negative or greater than the allowed value.

DOMStringSizeErr (DOMSTRING_SIZE_ERR)

Raised if the specified range of text does not fit into a DOMString.

HierarchyRequestErr (HIERARCHY_REQUEST_ERR)

Used if any node is inserted somewhere it doesn’t belong.

WrongDocumentErr (WRONG_DOCUMENT_ERR)

Used if a node is used in a different document than the one that created it (which doesn’t support it).

InvalidCharacterErr ...