Класс DOMException

org.w3c.dom.DOMException

Все реализуемые интерфейсы:: Serializable

public class DOMException extends RuntimeException

Операции DOM поднимают исключения только в "исключительных" случаях, то есть когда операцию невозможно выполнить (либо по логическим причинам, потому что данные потеряны, либо потому что реализация стала нестабильной). В общем случае, методы DOM возвращают определённые значения ошибок в обычных ситуациях обработки, такие как ошибки выхода за пределы допустимого диапазона при использовании NodeList.

Реализации должны поднимать другие исключения в других обстоятельствах. Например, реализации должны поднимать зависящее от реализации исключение, если передаётся аргумент null, когда null не ожидалось.

Некоторые языки и объектные системы не поддерживают концепцию исключений. В таких системах условия ошибок могут быть указаны с помощью собственных механизмов отчёта об ошибках. Для некоторых связываний, например, методы могут возвращать коды ошибок, аналогичные тем, что перечислены в описаниях соответствующих методов.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

С тех пор:

1.4, DOM Level 2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`short`	`code`
`static final short`	`DOMSTRING_SIZE_ERR`	Если заданный диапазон текста не помещается в `DOMString`.
`static final short`	`HIERARCHY_REQUEST_ERR`	Если любой `Node` вставлен где-то не туда.
`static final short`	`INDEX_SIZE_ERR`	Если индекс или размер отрицательный или больше разрешенного значения.
`static final short`	`INUSE_ATTRIBUTE_ERR`	Если предпринята попытка добавить атрибут, который уже используется где-то в другом месте.
`static final short`	`INVALID_ACCESS_ERR`	Если параметр или операция не поддерживаются базовым объектом.
`static final short`	`INVALID_CHARACTER_ERR`	Если указан недопустимый или некорректный символ, например, в имени XML.
`static final short`	`INVALID_MODIFICATION_ERR`	Если предпринята попытка изменить тип базового объекта.
`static final short`	`INVALID_STATE_ERR`	Если предпринята попытка использовать объект, который не используется или больше не используется.
`static final short`	`NAMESPACE_ERR`	Если предпринята попытка создать или изменить объект способом, не соответствующим правилам именования.
`static final short`	`NO_DATA_ALLOWED_ERR`	Если данные указаны для `Node`, который не поддерживает данные.
`static final short`	`NO_MODIFICATION_ALLOWED_ERR`	Если предпринята попытка изменить объект, где изменения запрещены.
`static final short`	`NOT_FOUND_ERR`	Если предпринята попытка обратиться к `Node` в контексте, где он не существует.
`static final short`	`NOT_SUPPORTED_ERR`	Если реализация не поддерживает запрашиваемый тип объекта или операции.
`static final short`	`SYNTAX_ERR`	Если указана недопустимая или некорректная строка.
`static final short`	`TYPE_MISMATCH_ERR`	Если тип объекта несовместим с ожидаемым типом параметра, связанного с объектом.
`static final short`	`VALIDATION_ERR`	Если вызов метода, такого как `insertBefore` или `removeChild`, сделает `Node` недействительным относительно «частичной валидности», это исключение будет поднято, и операция не будет выполнена.
`static final short`	`WRONG_DOCUMENT_ERR`	Если `Node` используется в другом документе, отличном от того, который его создал (который его не поддерживает).

Краткое описание конструкторов

Конструктор	Описание
`DOMException(short code, String message)`

Краткое описание методов

Методы, объявленные в классе java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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 вставлен не в то место.

См. также:

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

Если попытка использовать объект, который не является или больше не является пригодным для использования.

С:

1.4, DOM Level 2

См. также:

SYNTAX_ERR

public static final short SYNTAX_ERR

Если задана неверная или некорректная строка.

С:

1.4, DOM Level 2

См. также:

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR

Если попытка изменить тип базового объекта.

С:

1.4, DOM Level 2

См. также:

NAMESPACE_ERR

public static final short NAMESPACE_ERR

Если попытка создать или изменить объект таким образом, что это не соответствует правилам пространств имён.

С:

1.4, DOM Level 2

См. также:

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR

Если параметр или операция не поддерживаются базовым объектом.

С:

1.4, DOM Level 2

См. также:

VALIDATION_ERR

public static final short VALIDATION_ERR

Если вызов метода, такого как insertBefore или removeChild, сделает Node недопустимым относительно «частичной валидности», данное исключение будет поднято, а операция не будет выполнена. Данный код используется в [DOM Level 3 Validation]. Обратитесь к этому документу для получения дополнительной информации.

С:

1.5, DOM Level 3

См. также:

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR

Если тип объекта несовместим с ожидаемым типом параметра, связанного с объектом.

С:

1.5, DOM Level 3

См. также:

Подробное описание конструкторов

DOMException

public DOMException(short code, String message)

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/DOMException.html