DOMException 接口代表由于调用方法或访问一个web  API 属性时的异常事件. 这基本上是在web API中如何描述错误情况的

每个异常都有一个 name, 一个短的骆驼拼写法的字符串用于描述识别错误或异常情况。

构造函数

DOMException()
返回一个包含指定消息和名称的 DOMException 对象

属性

DOMException.code 只读
返回一个 short 包含error code constants其中之一, 或者返回 0如果没有匹配的话.  这个字段由于历史原因被使用. 现在不再使用这个新的DOM异常: 他们把这个信息放入 DOMException.name 属性.
DOMException.message 只读
返回一个 DOMString 代表与给定的 error name 有关信息或描述.
DOMException.name 只读
返回一个 DOMString 包含与 error name相关的字符串.

Error names错误名称

常见的错误名称列在这里. 一些 APIs 定义它们自己的一组的名称,所以这未必是一个完整的列表。

注意:因为历史上的错误是由数值与对应的命名变量定义的, 以下有些条目代表我们过去使用的遗留代码值和常量名.

IndexSizeError
索引不在允许的范围内。例如, 这可以被 Range 对象抛出. (遗留代码值: 1 和 遗留常数名称: INDEX_SIZE_ERR)
HierarchyRequestError
节点树层次结构是不正确的。(遗留代码值: 3 , 遗留常数名称: HIERARCHY_REQUEST_ERR)
WrongDocumentError
对象在错误的 Document. (遗留代码值: 4 和遗留常数名称: WRONG_DOCUMENT_ERR)
InvalidCharacterError
字符串包含无效字符. (Legacy code value: 5 and legacy constant name: INVALID_CHARACTER_ERR)
NoModificationAllowedError
对象不能被修改。 (Legacy code value: 7 and legacy constant name: NO_MODIFICATION_ALLOWED_ERR)
NotFoundError
对象不能在这里找到。 (Legacy code value: 8 and legacy constant name: NOT_FOUND_ERR)
NotSupportedError
不支持的操作。 (Legacy code value: 9 and legacy constant name: NOT_SUPPORTED_ERR)
InvalidStateError
对象是一个无效的状态. (Legacy code value: 11 and legacy constant name: INVALID_STATE_ERR)
SyntaxError
字符串不匹配预期的模式. (Legacy code value: 12 and legacy constant name: SYNTAX_ERR)
InvalidModificationError
对象不能被这种方式修改。 (Legacy code value: 13 and legacy constant name: INVALID_MODIFICATION_ERR)
NamespaceError
操作在XML名称空间是不允许的. (Legacy code value: 14 and legacy constant name: NAMESPACE_ERR)
InvalidAccessError
对象不支持此操作或参数 (Legacy code value: 15 and legacy constant name: INVALID_ACCESS_ERR)
TypeMismatchError
对象的类型不匹配预期的类型. (Legacy code value: 17 and legacy constant name: TYPE_MISMATCH_ERR) 这个值已被弃用,  JavaScript TypeError 异常被提出而不是DOMException
SecurityError
操作不安全。 (Legacy code value: 18 and legacy constant name: SECURITY_ERR)
NetworkError
网络错误发生. (Legacy code value: 19 and legacy constant name: NETWORK_ERR)
AbortError
T操作中止. (Legacy code value: 20 and legacy constant name: ABORT_ERR)
URLMismatchError
给定的URL不匹配另一个URL。 (Legacy code value: 21 and legacy constant name: URL_MISMATCH_ERR)
QuotaExceededError
给定配额已经超过了(Legacy code value: 22 and legacy constant name: QUOTA_EXCEEDED_ERR)
TimeoutError
操作超时. (Legacy code value: 23 and legacy constant name: TIMEOUT_ERR)
InvalidNodeTypeError
这个操作的节点是不正确的或祖先是不正确的. (Legacy code value: 24 and legacy constant name: INVALID_NODE_TYPE_ERR)
sDataCloneError
对象不可被克隆。 (Legacy code value: 25 and legacy constant name: DATA_CLONE_ERR)
EncodingError
编码或解码操作失败 (没有遗留代码值和常量的名字).
NotReadableError
输入/输出读操作失败(没有遗留代码值和常量的名字).
UnknownError
因未知的瞬态的原因使操作失败(例如 内存不足) (No legacy code value and constant name).
ConstraintError
条件没满足而导致事件失败的异常操作(No legacy code value and constant name).
DataError
提供的数据不够 (No legacy code value and constant name).
TransactionInactiveError
请求被当前不活跃的事件或已完成事件阻止。(No legacy code value and constant name).
ReadOnlyError
企图在 "readonly" 事件中操作造成异常  (No legacy code value and constant name).
VersionError
在比现有的版本低的版本中尝试打开一个数据库。(No legacy code value and constant name).
OperationError
因特定操作失败原因而失败 (No legacy code value and constant name).
NotAllowedError
用户代理或当前上下文平台不允许的请求,可能因为用户拒绝许可(No legacy code value and constant name).

规范

Specification Status Comment
Web IDL
constructor
Candidate Recommendation Adds the constructor for the DOMException class. Adds the NotReadableError, UnknownError, ConstraintError, DataError, TransactionInactiveError, ReadOnlyError, VersionError, OperationError, and NotAllowedError values.
DOM4
DOMException
Obsolete Added SECURITY_ERR, NETWORK_ERR, ABORT_ERR, URL_MISMATCH_ERR, QUOTA_EXCEEDED_ERR, TIMEOUT_ERR, INVALID_NODE_TYPE_ERR, and DATA_CLONE_ERR. The property code has been deprecated for exception values. The EncodingError value added.
Document Object Model (DOM) Level 3 Core Specification
DOMException
Obsolete Added of VALIDATION_ERR and TYPE_MISMATCH_ERR.
Document Object Model (DOM) Level 2 Core Specification
DOMException
Obsolete Added of INVALID_STATE_ERR, SYNTAX_ERR, INVALID_MODIFICATION_ERR, NAMESPACE_ERR, and INVALID_ACCESS_ERR.
Document Object Model (DOM) Level 1 Specification
DOMException
Obsolete Initial definition.

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

           
Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) 1.0 (1.7 or earlier) ? ? ?
DOM Level 4 support (Yes) ? 13.0 (13.0) ? ? ?
DATA_CLONE_ERR constant (Yes) (Yes) 5.0 (5.0) ? ? ?
Constructor 未实现 未实现 ? ? ? ?
           
Feature Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) (Yes) 1.0 (1.0) ? ? ? (Yes)
DOM Level 4 support ? (Yes) ? 13.0 (13.0) ? ? ? (Yes)
DATA_CLONE_ERR constant ? (Yes) (Yes) 5.0 (5.0) ? ? ? (Yes)
Constructor 未实现 未实现 未实现 ? ? ? ? 未实现

另请参阅

文档标签和贡献者

 此页面的贡献者: Pada
 最后编辑者: Pada,