DOMException()

The DOMException() constructor returns a DOMException object with a specified message and name.

Syntax

new DOMException()
new DOMException(message)
new DOMException(message, name)

Parameters

• message optional
  • : A description of the exception. If not present, the empty string '' is used.
• name optional
  • : A string. If the specified name is a standard error name, then getting the code property of the DOMException object will return the code number corresponding to the specified name.

Return value

A newly created DOMException object.

Error names

Common error names are listed here. Some APIs define their own sets of names, so this is not necessarily a complete list.

Note that the following deprecated historical errors don't have an error name but instead have only a legacy constant code value and a legacy constant name:

• Legacy code value: 2, legacy constant name: DOMSTRING_SIZE_ERR
• Legacy code value: 6, legacy constant name: NO_DATA_ALLOWED_ERR
• Legacy code value: 16, legacy constant name: VALIDATION_ERR

Note: Because historically the errors were identified by a numeric value that corresponded with a named variable defined to have that value, some of the entries below indicate the legacy code value and constant name that were used in the past.

• IndexSizeError
  • : The index is not in the allowed range. (Legacy code value: 1 and legacy constant name: INDEX_SIZE_ERR)
• HierarchyRequestError
  • : The node tree hierarchy is not correct. (Legacy code value: 3 and legacy constant name: HIERARCHY_REQUEST_ERR)
• WrongDocumentError
  • : The object is in the wrong Document. (Legacy code value: 4 and legacy constant name: WRONG_DOCUMENT_ERR)
• InvalidCharacterError
  • : The string contains invalid characters. (Legacy code value: 5 and legacy constant name: INVALID_CHARACTER_ERR)
• NoModificationAllowedError
  • : The object cannot be modified. (Legacy code value: 7 and legacy constant name: NO_MODIFICATION_ALLOWED_ERR)
• NotFoundError
  • : The object cannot be found here. (Legacy code value: 8 and legacy constant name: NOT_FOUND_ERR)
• NotSupportedError
  • : The operation is not supported. (Legacy code value: 9 and legacy constant name: NOT_SUPPORTED_ERR)
• InvalidStateError
  • : The object is in an invalid state. (Legacy code value: 11 and legacy constant name: INVALID_STATE_ERR)
• InUseAttributeError
  • : The attribute is in use. (Legacy code value: 10 and legacy constant name: INUSE_ATTRIBUTE_ERR)
• SyntaxError
  • : The string did not match the expected pattern. (Legacy code value: 12 and legacy constant name: SYNTAX_ERR)
• InvalidModificationError
  • : The object cannot be modified in this way. (Legacy code value: 13 and legacy constant name: INVALID_MODIFICATION_ERR)
• NamespaceError
  • : The operation is not allowed by Namespaces in XML. (Legacy code value: 14 and legacy constant name: NAMESPACE_ERR)
• InvalidAccessError
  • : The object does not support the operation or argument. (Legacy code value: 15 and legacy constant name: INVALID_ACCESS_ERR)
• TypeMismatchError deprecated
  • : The type of the object does not match the expected type. (Legacy code value: 17 and legacy constant name: TYPE_MISMATCH_ERR) This value is deprecated; the JavaScript TypeError exception is now raised instead of a DOMException with this value.
• SecurityError
  • : The operation is insecure. (Legacy code value: 18 and legacy constant name: SECURITY_ERR)
• NetworkError
  • : A network error occurred. (Legacy code value: 19 and legacy constant name: NETWORK_ERR)
• AbortError
  • : The operation was aborted. (Legacy code value: 20 and legacy constant name: ABORT_ERR)
• URLMismatchError
  • : The given URL does not match another URL. (Legacy code value: 21 and legacy constant name: URL_MISMATCH_ERR)
• QuotaExceededError
  • : The quota has been exceeded. (Legacy code value: 22 and legacy constant name: QUOTA_EXCEEDED_ERR)
• TimeoutError
  • : The operation timed out. (Legacy code value: 23 and legacy constant name: TIMEOUT_ERR)
• InvalidNodeTypeError
  • : The node is incorrect or has an incorrect ancestor for this operation. (Legacy code value: 24 and legacy constant name: INVALID_NODE_TYPE_ERR)
• DataCloneError
  • : The object can not be cloned. (Legacy code value: 25 and legacy constant name: DATA_CLONE_ERR)
• EncodingError
  • : The encoding or decoding operation failed (No legacy code value and constant name).
• NotReadableError
  • : The input/output read operation failed (No legacy code value and constant name).
• UnknownError
  • : The operation failed for an unknown transient reason (e.g. out of memory) (No legacy code value and constant name).
• ConstraintError
  • : A mutation operation in a transaction failed because a constraint was not satisfied (No legacy code value and constant name).
• DataError
  • : Provided data is inadequate (No legacy code value and constant name).
• TransactionInactiveError
  • : A request was placed against a transaction that is currently not active or is finished (No legacy code value and constant name).
• ReadOnlyError
  • : The mutating operation was attempted in a "readonly" transaction (No legacy code value and constant name).
• VersionError
  • : An attempt was made to open a database using a lower version than the existing version (No legacy code value and constant name).
• OperationError
  • : The operation failed for an operation-specific reason (No legacy code value and constant name).
• NotAllowedError
  • : The request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission (No legacy code value and constant name).