XML DOM - DOMException 对象

通知核心 DOM 对象的异常或通知。

常量

下面的常量定义了 DOMException 对象的 code 属性的合法值。

注释:这些常量是 DOMException 的静态属性,不是个别异常对象的属性。

INDEX_SIZE_ERR

说明数组或字符串下标的溢出错误。

DOMSTRING_SIZE_ERR

说明请求的文本太大,文本的指定范围不适合 DOMString。

HIERARCHY_REQUEST_ERR

说明发生了要把节点放在文档树层次中的不合法位置的操作。

WRONG_DOCUMENT_ERR

说明发生了从创建节点的文档以外的文档使用使用该节点的操作。

INVALID_CHARACTER_ERR

说明(比如在元素名中)使用了不合法的字符。

NO_DATA_ALLOWED_ERR

为不支持数据的 Node 指定数据。

NO_MODIFICATION_ALLOWED_ERR

说明发生了修改只读的、不允许修改的节点的操作。

NOT_FOUND_ERR

说明在期望的位置没有找到指定的节点

NOT_SUPPORTED_ERR

说明当前的 DOM 实现不支持某个属性或方法。

INUSE_ATTRIBUTE_ERR

说明在一个 Attr 节点已经关联到另一个 Element 节点时,发生了把一个 Attr 节点关联到另一个 Element 节点的操作。

INVALID_STATE_ERR

说明使用了处于不允许使用状态或不再允许使用状态的对象。

SYNTAX_ERR

说明指定的错误含有语法错误。通常由 CSS 属性声明使用。

INVALID_MODIFICATION_ERR

说明发生了修改 CSSRule 对象或 CSSValue 对象的操作。

NAMESPACE_ERR

说明有涉及元素或属性的命名空间的错误。

INVALID_ACCESS_ERR

说明以一种当前的实现不支持的方法访问对象。

code 属性

出错代码。提供了引发异常的原因的详细情况。该属性的合法值(和它们的含义)由前面列出的常量定义。

描述

当错误使用或在不适合的环境中使用某个 DOM 属性或方法时,就会抛出一个 DOMException 对象。code 属性的值说明了发生的异常的一般类型。注意,读写对象的属性或调用对象的方法时,都有可能抛出 DOMException 对象。

在 教程之家 提供的 XML DOM 参考手册中,对象的属性和方法的描述部分列出了可能抛出的异常。

注意,并非 DOM 中的所有异常都由 DOMException 通知:涉及 DOM Range 模块的异常,会导致抛出 RangeException 异常。