DOMException Class

DOMException class

The DOMException interface represents an abnormal event (called an exception) which occurs as a result of calling a method or accessing a property of a web API. This is basically how error conditions are described in web APIs.

public class DOMException : PlatformException


DOMException(string)Initializes a new instance of the DOMException class.
DOMException(string, string)Initializes a new instance of the DOMException class.


Code { get; }Returns a value that contains one of the error code constants, or 0 if none match. This field is used for historical reasons.
override Message { get; }Returns a string representing a message or description associated with the given error name.
Name { get; }Returns a string that contains one of the strings associated with an error name.


const ABORT_ERRThe operation was aborted.
const DATA_CLONE_ERRThe object can not be cloned.
const DOMSTRING_SIZE_ERRIf the specified range of text does not fit into a DOMString.
const HIERARCHY_REQUEST_ERRIf any Node is inserted somewhere it doesn’t belong.
const INDEX_SIZE_ERRIf index or size is negative, or greater than the allowed value.
const INUSE_ATTRIBUTE_ERRIf an attempt is made to add an attribute that is already in use elsewhere.
const INVALID_ACCESS_ERRIf a parameter or an operation is not supported by the underlying object.
const INVALID_CHARACTER_ERRIf an invalid or illegal character is specified, such as in an XML name.
const INVALID_EXPRESSION_ERRThe expression has a syntax error or otherwise is not a legal expression according to the rules of the specific XPathEvaluator or contains specialized extension functions or variables not supported by this implementation.
const INVALID_MODIFICATION_ERRIf an attempt is made to modify the type of the underlying object.
const INVALID_NODE_TYPE_ERRThe supplied node is incorrect or has an incorrect ancestor for this operation.
const INVALID_STATE_ERRIf an attempt is made to use an object that is not, or is no longer, usable.
const NAMESPACE_ERRIf an attempt is made to create or change an object in a way which is incorrect with regard to namespaces.
const NETWORK_ERRA network error occurred.
const NOT_FOUND_ERRIf an attempt is made to reference a Node in a context where it does not exist.
const NOT_SUPPORTED_ERRIf the implementation does not support the requested type of object or operation.
const NO_DATA_ALLOWED_ERRIf data is specified for a Node which does not support data.
const NO_MODIFICATION_ALLOWED_ERRIf an attempt is made to modify an object where modifications are not allowed.
const QUOTA_EXCEEDED_ERRThe quota has been exceeded.
const SECURITY_ERRThe operation is insecure.
const SYNTAX_ERRIf an invalid or illegal string is specified.
const TIMEOUT_ERRThe operation timed out.
const TYPE_ERRThe expression cannot be converted to return the specified type.
const TYPE_MISMATCH_ERRIf the type of an object is incompatible with the expected type of the parameter associated to the object.
const URL_MISMATCH_ERRThe given URL does not match another URL.
const VALIDATION_ERRIf a call to a method such as insertBefore or removeChild would make the Node invalid with respect to “partial validity”, this exception would be raised and the operation would not be done. This code is used in [DOM Level 3 Validation]. Refer to this specification for further information.
const WRONG_DOCUMENT_ERRIf a Node is used in a different document than the one that created it (that doesn’t support it).

See Also