Spec-Zone.ru › OpenJDK 25

Класс DOMException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.w3c.dom.DOMException
Все реализованные интерфейсы:
Serializable
public class DOMException extends RuntimeException
Операции DOM вызывают исключения только в «исключительных» обстоятельствах, то есть когда операцию невозможно выполнить (по логическим причинам, из-за потери данных или нестабильности реализации). Как правило, методы DOM возвращают определённые значения ошибок в обычных ситуациях обработки, например ошибки выхода за границы при использовании NodeList.

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

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

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

Начиная с версии:
1.4, DOM уровня 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

Методы, объявленные в классе 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 уровня 2
См. также:
  • Значения константных полей

SYNTAX_ERR

public static final short SYNTAX_ERR
Если указана недопустимая или запрещённая строка.
Начиная с версии:
1.4, DOM уровня 2
См. также:
  • Значения константных полей

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR
Если предпринята попытка изменить тип базового объекта.
Начиная с версии:
1.4, DOM уровня 2
См. также:
  • Значения константных полей

NAMESPACE_ERR

public static final short NAMESPACE_ERR
Если предпринята попытка создать или изменить объект способом, нарушающим правила использования пространств имён.
Начиная с версии:
1.4, DOM уровня 2
См. также:
  • Значения константных полей

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR
Если базовый объект не поддерживает параметр или операцию.
Начиная с версии:
1.4, DOM уровня 2
См. также:
  • Значения константных полей

VALIDATION_ERR

public static final short VALIDATION_ERR
Если вызов метода, например insertBefore или removeChild, приведёт к нарушению «частичной допустимости» для Node, будет вызвано это исключение, а операция не будет выполнена. Этот код используется в [Валидации DOM уровня 3]. Дополнительные сведения см. в этой спецификации.
Начиная с версии:
1.5, DOM уровня 3
См. также:
  • Значения константных полей

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR
Если тип объекта несовместим с ожидаемым типом параметра, связанного с объектом.
Начиная с версии:
1.5, DOM уровня 3
См. также:
  • Значения константных полей

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

DOMException

public DOMException(short code, String message)

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/DOMException.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API