NAME

HTML::DOM::Exception - The Exception interface for HTML::DOM

SYNOPSIS

use HTML::DOM::Exception 'INVALID_CHARACTER_ERR';

eval {
        die new HTML::DOM::Exception
                INVALID_CHARACTER_ERR,
                'Only ASCII characters allowed!'
};

$@ == INVALID_CHARACTER_ERR; # true

print $@;    # prints "Only ASCII characters allowed!\n";

DESCRIPTION

This module implementations the W3C's DOMException interface. HTML::DOM::Exception objects stringify to the message passed to the constructer and numify to the error number (see below, under 'EXPORTS').

METHODS

new HTML::DOM::Exception $type, $message

This class method creates a new exception object. $type is expected to be an integer (you can use the constants listed under 'EXPORTS'). $message is the error message.

EXPORTS

The following constants are optionally exported. The descriptions are copied from the DOM spec.

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 somewhere it doesn't belong

WRONG_DOCUMENT_ERR (4)

If a node is used in a different document than the one that created it (that doesn't support 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 which does not support data

NO_MODIFICATION_ALLOWED_ERR (7)

If an attempt is made to modify an object where modifications are not allowed

NOT_FOUND_ERR (8)

If an attempt was made to reference a node in a context where 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 inuse elsewhere

SEE ALSO

HTML::DOM