此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
DOMException
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
DOMException 接口代表调用方法或访问 Web API 属性时发生的不正常事件（被称为异常，exception）。这就是 Web API 中描述错误条件的方式。
每个异常都有一个名称（name），一个采用驼峰命名法的简短字符串，用于描述识别错误或异常情况。
DOMException 是一个可序列化对象，因此可以使用structuredClone() 克隆，或使用postMessage() 在Worker 之间复制。
构造函数
DOMException()返回一个包含指定消息和名称的
DOMException对象。
实例属性
DOMException.code已弃用只读返回任意一个遗留错误代码常量，如果不匹配则返回
0。DOMException.message只读返回一个字符串，代表与给定的错误名称有关的信息或描述。
DOMException.name只读返回一个字符串，包含与错误名称相关的字符串。
错误名称
常见的错误名称列在这里。一些 API 定义了它们自己的名称组，所以这未必是一个完整的列表。
请注意，以下已废弃的历史错误没有错误名称，而只有遗留常量代码值和遗留常量名称：
- 遗留代码值：
2，遗留常量名称：DOMSTRING_SIZE_ERR - 遗留代码值：
6，遗留常量名称：NO_DATA_ALLOWED_ERR - 遗留代码值：
16，遗留常量名称：VALIDATION_ERR
备注：由于历史上错误是通过一个数值来识别的，该数值与定义为该数值的命名变量相对应，因此下面的一些条目指出了过去使用的历史代码值和常量名称。
IndexSizeError索引不在允许的范围内。例如，这可以被
Range对象抛出。（遗留代码值：1，遗留常量名称：INDEX_SIZE_ERR）HierarchyRequestError节点树层次结构有误。（遗留代码值：
3，遗留常量名称：HIERARCHY_REQUEST_ERR）WrongDocumentError对象在错误的
Document中。（遗留代码值：4，遗留常量名称：WRONG_DOCUMENT_ERR）InvalidCharacterError字符串包含无效字符。（遗留代码值：
5，遗留常量名称：INVALID_CHARACTER_ERR）NoModificationAllowedError对象不能被修改。（遗留代码值：
7，遗留常量名称：NO_MODIFICATION_ALLOWED_ERR）NotFoundError找不到对象。（遗留代码值：
8，遗留常量名称：NOT_FOUND_ERR）NotSupportedError不支持的操作。（遗留代码值：
9，遗留常量名称：NOT_SUPPORTED_ERR）InvalidStateError对象是一个无效的状态。（遗留代码值：
11，遗留常量名称：INVALID_STATE_ERR）SyntaxError字符串不匹配预期的模式。（遗留代码值：
12，遗留常量名称：SYNTAX_ERR）InvalidModificationError对象不能被这种方式修改。（遗留代码值：
13，遗留常量名称：INVALID_MODIFICATION_ERR）NamespaceError操作在 XML 名称空间是不允许的。（遗留代码值：
14，遗留常量名称：NAMESPACE_ERR）InvalidAccessError对象不支持此操作或参数。（遗留代码值：
15，遗留常量名称：INVALID_ACCESS_ERR）TypeMismatchError已弃用对象的类型不匹配预期的类型。（遗留代码值：
17，遗留常量名称：TYPE_MISMATCH_ERR）。这个值已被弃用，现在会抛出 JavaScriptTypeError异常而不是含有该值的DOMException。SecurityError实验性操作不安全。（遗留代码值：
18，遗留常量名称：SECURITY_ERR）NetworkError实验性网络错误发生。（遗留代码值：
19，遗留常量名称：NETWORK_ERR）AbortError实验性操作中止。（遗留代码值：
20，遗留常量名称：ABORT_ERR）URLMismatchError实验性给定的 URL 不匹配另一个 URL。（遗留代码值：
21，遗留常量名称：URL_MISMATCH_ERR）QuotaExceededError实验性超出给定配额。（遗留代码值：
22，遗留常量名称：QUOTA_EXCEEDED_ERR）TimeoutError实验性操作超时。（遗留代码值：
23，遗留常量名称：TIMEOUT_ERR）InvalidNodeTypeError实验性这个操作的节点是不正确的或祖先是不正确的。（遗留代码值：
24，遗留常量名称：INVALID_NODE_TYPE_ERR）DataCloneError实验性对象不可被克隆。（遗留代码值：
25，遗留常量名称：DATA_CLONE_ERR）EncodingError实验性编码或解码操作失败（没有遗留代码值和常量的名字）。
NotReadableError实验性输入/输出读操作失败（没有遗留代码值和常量的名字）。
UnknownError实验性因未知的瞬态的原因使操作失败（例如内存不足）（没有遗留代码值和常量的名字）。
ConstraintError实验性条件没满足而导致事件失败的异常操作（没有遗留代码值和常量的名字）。
DataError实验性提供的数据不足（没有遗留代码值和常量的名字）。
TransactionInactiveError实验性请求被当前不活跃的事件或已完成事件阻止（没有遗留代码值和常量的名字）。
ReadOnlyError实验性尝试操作“只读”事件（没有遗留代码值和常量的名字）。
VersionError实验性尝试打开一个比现有版本更低的数据库（没有遗留代码值和常量的名字）。
OperationError实验性因特定操作失败原因而失败（没有遗留代码值和常量的名字）。
NotAllowedError实验性当前上下文中的用户代理或平台不允许该请求，可能是因为用户拒绝了授权（没有遗留代码值和常量的名字）。
规范
| Specification |
|---|
| Web IDL # idl-DOMException |