DOMException
DOMException
接口代表调用方法或访问 Web API 属性时发生的异常事件(被称为异常,exception)。 这基本上是在 Web API 中如何描述错误情况的
每个异常都有一个名称 name,一个采用骆驼式命名法的简短字符串,用于描述识别错误或异常情况。
译者注:骆驼式命名法(CamelCase style),又称驼峰命名法。与 JavaScript 中更常见的小驼峰命名法有别,此处应是指大驼峰命名法。大驼峰命名法又称 Pascal 命名法。具体为名称中的每个单词仅首字母大写(Capitalize),可参考下方错误名称。
构造函数
DOMException()
Experimental- 返回一个包含指定消息和名称的
DOMException
对象。
属性
DOMException.code
Deprecated 只读- 返回一个
short
,包含错误代码常量中的一个,或者返回0
,如果没有匹配的话。这个字段由于历史原因被使用。现在不再使用这个新的 DOM 异常:他们把这个信息放入DOMException.name
(en-US) 属性。 DOMException.message
(en-US) 只读- 返回一个
DOMString
代表与给定的错误名称有关信息或描述。 DOMException.name
(en-US) 只读- 返回一个
DOMString
包含与错误名称相关的字符串。
错误名称
常见的错误名称列在这里。一些 API 定义了它们自己的名称组,所以这未必是一个完整的列表。
注意:因为很久以前错误是由数值(code value,代码值)与一个对应的命名变量定义的,所以以下部分条目包含过去使用的遗留代码值和常量名。
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
Deprecated- 对象的类型不匹配预期的类型. (Legacy code value:
17
and legacy constant name:TYPE_MISMATCH_ERR
) 这个值已被弃用, JavaScriptTypeError
异常被提出而不是DOMException
SecurityError
Experimental- 操作不安全。 (Legacy code value:
18
and legacy constant name:SECURITY_ERR
) NetworkError
Experimental- 网络错误发生. (Legacy code value:
19
and legacy constant name:NETWORK_ER
R
) AbortError
Experimental- T 操作中止. (Legacy code value:
20
and legacy constant name:ABORT_ERR
) URLMismatchError
Experimental- 给定的 URL 不匹配另一个 URL。 (Legacy code value:
21
and legacy constant name:URL_MISMATCH_ERR
) QuotaExceededError
Experimental- 给定配额已经超过了 (Legacy code value:
22
and legacy constant name:QUOTA_EXCEEDED_ERR
) TimeoutError
Experimental- 操作超时. (Legacy code value:
23
and legacy constant name:TIMEOUT_ERR
) InvalidNodeTypeError
Experimental- 这个操作的节点是不正确的或祖先是不正确的. (Legacy code value:
24
and legacy constant name:INVALID_NODE_TYPE_ERR
) sDataCloneError
Experimental- 对象不可被克隆。 (Legacy code value:
25
and legacy constant name:DATA_CLONE_ERR
) EncodingError
Experimental- 编码或解码操作失败 (没有遗留代码值和常量的名字).
NotReadableError
Experimental- 输入/输出读操作失败 (没有遗留代码值和常量的名字).
UnknownError
Experimental- 因未知的瞬态的原因使操作失败 (例如 内存不足) (No legacy code value and constant name).
ConstraintError
Experimental- 条件没满足而导致事件失败的异常操作 (No legacy code value and constant name).
DataError
Experimental- 提供的数据不足 (No legacy code value and constant name).
TransactionInactiveError
Experimental- 请求被当前不活跃的事件或已完成事件阻止 (No legacy code value and constant name)。
ReadOnlyError
Experimental- 尝试操作 "readonly" 事件 (No legacy code value and constant name)。
VersionError
Experimental- 尝试打开一个比现有版本更低的数据库 (No legacy code value and constant name)。
OperationError
Experimental- 因特定操作失败原因而失败 (No legacy code value and constant name).
NotAllowedError
Experimental- <dd 请求不被用户代理或当前上下文所在平台允许,可能因为用户拒绝授权 (no="" and="" code="" constant="" dd="" legacy="" name)。<="" value=""> </dd 请求不被用户代理或当前上下文所在平台允许,可能因为用户拒绝授权>
规范
Specification |
---|
Web IDL Standard # idl-DOMException |
浏览器兼容性
BCD tables only load in the browser