NAME

CSS::DOM::Exception - The Exception interface for CSS::DOM

SYNOPSIS

  use CSS::DOM::Exception 'SYNTAX_ERR';
  eval {
          die new CSS::DOM::Exception
                  SYNTAX_ERR,
                  '1 is not a valid property declaration'
  };
  $@ == SYNTAX_ERR; # true
  print $@;    # prints "1 is not a valid property declaration\n";

DESCRIPTION

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

METHODS

new CSS::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

INVALID_STATE_ERR (11)

If an attempt is made to use an object that is not, or is no longer, usable

SYNTAX_ERR (12)

If an invalid or illegal string is specified

INVALID_MODIFICATION_ERR (13)

If an attempt is made to modify the type of the underlying object

NAMESPACE_ERR (14)

If an attempt is made to create or change an object in a way which is incorrect with regard to namespaces

INVALID_ACCESS_ERR (15)

If a parameter or an operation is not supported by the underlying object

SEE ALSO

CSS::DOM, HTML::DOM::Exception