org.w3c.dom
类 DOMException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.w3c.dom.DOMException

所有已实现的接口：

Serializable

public class DOMException
extends RuntimeException

DOM 操作只在 "exceptional" 情况下引发异常，即不能执行操作时（由于逻辑原因，因为丢失数据或因为实现变得不稳定）。通常，DOM 方法在普通处理情况下返回特定的错误值，如使用 NodeList 时的超出边界错误。

实现应该在其他情况下引发其他异常。例如，如果不期望是 null 时传递 null 参数，则实现应该引发一个与实现有关的异常。

有些语言和对象系统不支持异常的概念。对于这样的系统，可以使用本机错误报告机制指示错误情况。例如，对于一些绑定，方法可以返回错误代码，它们类似于在相应方法描述中列出的错误代码。

另请参见 Document Object Model (DOM) Level 3 Core Specification。

另请参见：

序列化表格

字段摘要

short	code
static short	DOMSTRING_SIZE_ERR 如果文本的指定范围不适合 DOMString。
static short	HIERARCHY_REQUEST_ERR 如果在不属于 Node 的位置将任何 Node 插入。
static short	INDEX_SIZE_ERR 如果索引或大小为负，或大于允许的值。
static short	INUSE_ATTRIBUTE_ERR 如果试图添加已经在其他位置使用的属性。
static short	INVALID_ACCESS_ERR 如果基础对象不支持某个参数或操作。
static short	INVALID_CHARACTER_ERR 如果指定无效或非法字符，如在 XML 名称中。
static short	INVALID_MODIFICATION_ERR 如果试图修改基础对象的类型。
static short	INVALID_STATE_ERR 如果试图使用不可用或不再可用的对象。
static short	NAMESPACE_ERR 如果试图以一种与名称空间有关的错误的方式创建或更改一个对象。
static short	NO_DATA_ALLOWED_ERR 如果为不支持数据的 Node 指定数据。
static short	NO_MODIFICATION_ALLOWED_ERR 如果试图在不允许修改的位置修改对象。
static short	NOT_FOUND_ERR 如果试图在它不存在的上下文中引用 Node。
static short	NOT_SUPPORTED_ERR 如果实现不支持请求类型的对象或操作。
static short	SYNTAX_ERR 如果指定无效或非法字符串。
static short	TYPE_MISMATCH_ERR 如果对象的类型和与此对象相关联的参数的期望类型不兼容。
static short	VALIDATION_ERR 如果调用诸如 insertBefore 或 removeChild 之类的方法使 Node 无效(和 "partial validity" 有关的），则引发此异常并且将不进行操作。
static short	WRONG_DOCUMENT_ERR 如果 Node 用于不同的文档而不是创建它的文档（该文档不支持它）。

构造方法摘要

DOMException(short code, String message)

方法摘要

从类 java.lang.Throwable 继承的方法

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

code

public short code

INDEX_SIZE_ERR

public static final short INDEX_SIZE_ERR

如果索引或大小为负，或大于允许的值。

另请参见：

常量字段值

DOMSTRING_SIZE_ERR

public static final short DOMSTRING_SIZE_ERR

如果文本的指定范围不适合 DOMString。

另请参见：

常量字段值

HIERARCHY_REQUEST_ERR

public static final short HIERARCHY_REQUEST_ERR

如果在不属于 Node 的位置将任何 Node 插入。

另请参见：

常量字段值

WRONG_DOCUMENT_ERR

public static final short WRONG_DOCUMENT_ERR

如果 Node 用于不同的文档而不是创建它的文档（该文档不支持它）。

另请参见：

常量字段值

INVALID_CHARACTER_ERR

public static final short INVALID_CHARACTER_ERR

如果指定无效或非法字符，如在 XML 名称中。

另请参见：

常量字段值

NO_DATA_ALLOWED_ERR

public static final short NO_DATA_ALLOWED_ERR

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

另请参见：

常量字段值

NO_MODIFICATION_ALLOWED_ERR

public static final short NO_MODIFICATION_ALLOWED_ERR

如果试图在不允许修改的位置修改对象。

另请参见：

常量字段值

NOT_FOUND_ERR

public static final short NOT_FOUND_ERR

如果试图在它不存在的上下文中引用 Node。

另请参见：

常量字段值

NOT_SUPPORTED_ERR

public static final short NOT_SUPPORTED_ERR

如果实现不支持请求类型的对象或操作。

另请参见：

常量字段值

INUSE_ATTRIBUTE_ERR

public static final short INUSE_ATTRIBUTE_ERR

如果试图添加已经在其他位置使用的属性。

另请参见：

常量字段值

INVALID_STATE_ERR

public static final short INVALID_STATE_ERR

如果试图使用不可用或不再可用的对象。

从以下版本开始：

DOM Level 2

另请参见：

常量字段值

SYNTAX_ERR

public static final short SYNTAX_ERR

如果指定无效或非法字符串。

从以下版本开始：

DOM Level 2

另请参见：

常量字段值

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR

如果试图修改基础对象的类型。

从以下版本开始：

DOM Level 2

另请参见：

常量字段值

NAMESPACE_ERR

public static final short NAMESPACE_ERR

如果试图以一种与名称空间有关的错误的方式创建或更改一个对象。

从以下版本开始：

DOM Level 2

另请参见：

常量字段值

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR

如果基础对象不支持某个参数或操作。

从以下版本开始：

DOM Level 2

另请参见：

常量字段值

VALIDATION_ERR

public static final short VALIDATION_ERR

如果调用诸如 insertBefore 或 removeChild 之类的方法使 Node 无效(和 "partial validity" 有关的），则引发此异常并且将不进行操作。此代码用于 [DOM Level 3 Validation]。更多的信息，请参见此规范。

从以下版本开始：

DOM Level 3

另请参见：

常量字段值

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR

如果对象的类型和与此对象相关联的参数的期望类型不兼容。

从以下版本开始：

DOM Level 3

另请参见：

常量字段值

构造方法详细信息

DOMException

public DOMException(short code,
                    String message)