Класс DOMException

org.w3c.dom.DOMException

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

public class DOMException extends RuntimeException

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

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

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

См. также Основную спецификацию объектной модели документа (DOM), уровень 3.

Начиная с версии:

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)`

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

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

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным для вызова этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, для вызова этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку стека в указанный объект записи.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задаёт элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методом `Throwable.printStackTrace()` и связанными методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного времени.

Подробное описание полей

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]. Дополнительную информацию см. в этой спецификации.

Начиная с версии:

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.