就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. DOMException

在此页

DOMException interface represents an abnormal event (called an exception ) that 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.

Each exception has a 名称 , which is a short "CamelCase" style string identifying the error or abnormal condition.

构造函数

DOMException()
返回 DOMException object with a specified message and name.

特性

DOMException.code 只读
返回 short that contains one of the error code constants, or 0 if none match. This field is used for historical reasons. New DOM exceptions don't use this anymore: they put this info in the DOMException.name 属性。
DOMException.message 只读
返回 DOMString representing a message or description associated with the given error name .
DOMException.name 只读
返回 DOMString that contains one of the strings associated with an error name .

错误名称

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

注意 : 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. For example, this can be thrown by the 范围 object. (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 )
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
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).

规范

规范 状态 注释
Web IDL
The definition of 'constructor' in that specification. 		候选推荐 Adds the constructor for the DOMException class. Adds the NotReadableError , UnknownError , ConstraintError , DataError , TransactionInactiveError , ReadOnlyError , VersionError , OperationError ，和 NotAllowedError 值。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
DOMException Chrome Yes Edge ≤18 Firefox 1 IE ? Opera Yes Safari Yes WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
DOMException() 构造函数 Chrome Yes Edge 79 Firefox ? IE ? Opera Yes Safari ? WebView Android Yes Chrome Android Yes Firefox Android ? Opera Android Yes Safari iOS ? Samsung Internet Android Yes
code Chrome Yes Edge 12 Firefox 1 IE ? Opera Yes Safari Yes WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
message Chrome Yes Edge 12 Firefox 1 IE ? Opera Yes Safari Yes WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
名称 Chrome Yes Edge 12 Firefox 1 IE ? Opera Yes Safari Yes WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes

图例

完整支持

完整支持

兼容性未知 ?

兼容性未知

另请参阅

元数据

  • 最后修改：
  1. DOM (文档对象模型)
  2. DOMException
  3. 构造函数
    1. DOMException()
  4. 特性
    1. code
    2. message
    3. 名称
  5. DOM 相关页面
    1. AbortController
    2. AbortSignal
    3. AbstractRange
    4. Attr
    5. ByteString
    6. CDATASection
    7. CSSPrimitiveValue
    8. CSSValue
    9. CSSValueList
    10. CharacterData
    11. ChildNode
    12. 注释
    13. CustomEvent
    14. DOMConfiguration
    15. DOMError
    16. DOMErrorHandler
    17. DOMImplementation
    18. DOMImplementationList
    19. DOMImplementationRegistry
    20. DOMImplementationSource
    21. DOMLocator
    22. DOMObject
    23. DOMParser
    24. DOMPoint
    25. DOMPointInit
    26. DOMPointReadOnly
    27. DOMRect
    28. DOMString
    29. DOMTimeStamp
    30. DOMTokenList
    31. DOMUserData
    32. Document
    33. DocumentFragment
    34. DocumentType
    35. 元素
    36. ElementTraversal
    37. Entity
    38. EntityReference
    39. 事件
    40. EventTarget
    41. HTMLCollection
    42. MutationObserver
    43. 节点
    44. NodeFilter
    45. NodeIterator
    46. NodeList
    47. NonDocumentTypeChildNode
    48. ProcessingInstruction
    49. PromiseResolver
    50. 范围
    51. StaticRange
    52. 文本
    53. TextDecoder
    54. TextEncoder
    55. TimeRanges
    56. TreeWalker
    57. TypeInfo
    58. USVString
    59. UserDataHandler
    60. XMLDocument