public class DOMException
extends RuntimeException
java.lang.Object | ||||
↳ | java.lang.Throwable | |||
↳ | java.lang.Exception | |||
↳ | java.lang.RuntimeException | |||
↳ | org.w3c.dom.DOMException |
在“特殊”情况下,即操作不可能执行时(出于逻辑原因,因为数据丢失或实施变得不稳定),DOM操作仅会引发异常。 通常,DOM方法在普通处理情况下返回特定的错误值,例如在使用NodeList
时出现的出界错误。
在其他情况下,实施应提出其他例外。 例如,如果在null
不是预期的情况下传递null
参数,则实现应该引发实现相关异常。
有些语言和对象系统不支持异常的概念。 对于这样的系统,可以使用本地错误报告机制来指示错误状况。 例如,对于某些绑定,方法可能会返回类似于相应方法描述中列出的错误代码。
另见 Document Object Model (DOM) Level 3 Core Specification 。
Constants |
|
---|---|
short |
DOMSTRING_SIZE_ERR 如果指定范围的文字不符合 |
short |
HIERARCHY_REQUEST_ERR 如果有任何 |
short |
INDEX_SIZE_ERR 如果索引或大小为负值,或大于允许的值。 |
short |
INUSE_ATTRIBUTE_ERR 如果尝试添加已在别处使用的属性。 |
short |
INVALID_ACCESS_ERR 如果参数或操作不被底层对象支持。 |
short |
INVALID_CHARACTER_ERR 如果指定了无效或非法字符,例如在XML名称中。 |
short |
INVALID_MODIFICATION_ERR 如果试图修改底层对象的类型。 |
short |
INVALID_STATE_ERR 如果试图使用不是或不再可用的对象。 |
short |
NAMESPACE_ERR 如果试图以对命名空间不正确的方式创建或更改对象。 |
short |
NOT_FOUND_ERR 如果试图在不存在的上下文中引用 |
short |
NOT_SUPPORTED_ERR 如果实现不支持请求类型的对象或操作。 |
short |
NO_DATA_ALLOWED_ERR 如果数据指定为不支持数据的 |
short |
NO_MODIFICATION_ALLOWED_ERR 如果尝试修改不允许修改的对象。 |
short |
SYNTAX_ERR 如果指定了无效或非法字符串。 |
short |
TYPE_MISMATCH_ERR 如果对象的类型与与该对象关联的参数的预期类型不兼容。 |
short |
VALIDATION_ERR 如果对某个方法(如 |
short |
WRONG_DOCUMENT_ERR 如果 |
Fields |
|
---|---|
public short |
code |
Public constructors |
|
---|---|
DOMException(short code, String message) |
Inherited methods |
|
---|---|
From class java.lang.Throwable
|
|
From class java.lang.Object
|
short DOMSTRING_SIZE_ERR
如果指定范围的文字不符合 DOMString
。
常量值:2(0x00000002)
short HIERARCHY_REQUEST_ERR
如果任何 Node
插入某个地方它不属于。
常量值:3(0x00000003)
short INUSE_ATTRIBUTE_ERR
如果尝试添加已在别处使用的属性。
常量值:10(0x0000000a)
short INVALID_ACCESS_ERR
如果参数或操作不被底层对象支持。
常量值:15(0x0000000f)
short INVALID_CHARACTER_ERR
如果指定了无效或非法字符,例如在XML名称中。
常量值:5(0x00000005)
short INVALID_MODIFICATION_ERR
如果试图修改底层对象的类型。
常量值:13(0x0000000d)
short NO_DATA_ALLOWED_ERR
如果数据为不支持数据的 Node
指定。
常数值:6(0x00000006)
short NO_MODIFICATION_ALLOWED_ERR
如果尝试修改不允许修改的对象。
常量值:7(0x00000007)
short TYPE_MISMATCH_ERR
如果对象的类型与与该对象关联的参数的预期类型不兼容。
常量值:17(0x00000011)
short VALIDATION_ERR
如果对某个方法(如insertBefore
或removeChild
将导致Node
在“部分有效性”方面无效,则会引发此异常并且不会执行操作。 该代码用于[ DOM Level 3 Validation ]。 有关更多信息,请参阅此规范。
常量值:16(0x00000010)
short WRONG_DOCUMENT_ERR
如果 Node
在不同于创建它的文档中使用(不支持它)。
常量值:4(0x00000004)
DOMException (short code, String message)
Parameters | |
---|---|
code |
short
|
message |
String
|