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:
5and legacy constant name:INVALID_CHARACTER_ERR) NoModificationAllowedError- 对象不能被修改。 (Legacy code value:
7and legacy constant name:NO_MODIFICATION_ALLOWED_ERR) NotFoundError- 对象不能在这里找到。 (Legacy code value:
8and legacy constant name:NOT_FOUND_ERR) NotSupportedError- 不支持的操作。 (Legacy code value:
9and legacy constant name:NOT_SUPPORTED_ERR) InvalidStateError- 对象是一个无效的状态. (Legacy code value:
11and legacy constant name:INVALID_STATE_ERR) SyntaxError- 字符串不匹配预期的模式. (Legacy code value:
12and legacy constant name:SYNTAX_ERR) InvalidModificationError- 对象不能被这种方式修改。 (Legacy code value:
13and legacy constant name:INVALID_MODIFICATION_ERR) NamespaceError- 操作在XML名称空间是不允许的. (Legacy code value:
14and legacy constant name:NAMESPACE_ERR) InvalidAccessError- 对象不支持此操作或参数 (Legacy code value:
15and legacy constant name:INVALID_ACCESS_ERR) TypeMismatchError- 对象的类型不匹配预期的类型. (Legacy code value:
17and legacy constant name:TYPE_MISMATCH_ERR) 这个值已被弃用, JavaScriptTypeError异常被提出而不是DOMException SecurityError- 操作不安全。 (Legacy code value:
18and legacy constant name:SECURITY_ERR) NetworkError- 网络错误发生. (Legacy code value:
19and legacy constant name:NETWORK_ERR) AbortError- T操作中止. (Legacy code value:
20and legacy constant name:ABORT_ERR) URLMismatchError- 给定的URL不匹配另一个URL。 (Legacy code value:
21and legacy constant name:URL_MISMATCH_ERR) QuotaExceededError- 给定配额已经超过了(Legacy code value:
22and legacy constant name:QUOTA_EXCEEDED_ERR) TimeoutError- 操作超时. (Legacy code value:
23and legacy constant name:TIMEOUT_ERR) InvalidNodeTypeError- 这个操作的节点是不正确的或祖先是不正确的. (Legacy code value:
24and legacy constant name:INVALID_NODE_TYPE_ERR) sDataCloneError- 对象不可被克隆。 (Legacy code value:
25and 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 | 未实现 | 未实现 | 未实现 | ? | ? | ? | ? | 未实现 |