Spec-Zone.ru › OpenJDK 21

Класс 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 не ожидалось.

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

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

См. также:
  • Сериализованная форма

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

Модификатор и тип Поле Описание
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, 2023, 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/21/docs/api/java.xml/org/w3c/dom/DOMException.html

Spec-Zone.ru

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