DOMException

Базовая реализация Широко поддерживается *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь разную степень поддержки.

Примечание: Эта функция доступна в Web Workers.

Интерфейс DOMException представляет собой необычное событие (называемое исключением), которое происходит в результате вызова метода или доступа к свойству веб-API. Так описываются условия ошибок в веб-API.

Каждое исключение имеет имя, которое представляет собой короткую строку в стиле "PascalCase", идентифицирующую ошибку или аномальное состояние.

DOMException является сериализуемым объектом, поэтому его можно клонировать с помощью structuredClone() или копировать между потоками-рабочими с использованием postMessage().

Конструктор

DOMException(): Возвращает объект DOMException с указанным сообщением и именем.

Свойства экземпляра

DOMException.code Устаревший Только для чтения: Возвращает одно из устаревших значений кода ошибки или 0 , если нет совпадений.
DOMException.message Только для чтения: Возвращает строку, представляющую сообщение или описание, связанное с заданным именем ошибки.
DOMException.name Только для чтения: Возвращает строку, содержащую одно из значений, связанных с именем ошибки.

Имена ошибок

Здесь перечислены распространённые имена ошибок. Некоторые API определяют собственные наборы имён, поэтому этот список не является исчерпывающим.

Обратите внимание, что следующие устаревшие исторические ошибки не имеют имени ошибки, а вместо этого имеют только значение кода устаревшей константы и имя устаревшей константы:

Устаревшее значение кода: 2, устаревшее имя константы: DOMSTRING_SIZE_ERR
Устаревшее значение кода: 6, устаревшее имя константы: NO_DATA_ALLOWED_ERR
Устаревшее значение кода: 16, устаревшее имя константы: VALIDATION_ERR

Примечание: Поскольку исторически ошибки определялись численным значением, соответствующим имени переменной, определённой с этим значением, некоторые записи ниже указывают устаревшее значение кода и имя константы, используемые в прошлом.

IndexSizeError: Индекс находится вне допустимого диапазона. Например, это может быть вызвано объектом Range. (Устаревшее значение кода: 1 и устаревшее имя константы: INDEX_SIZE_ERR)
HierarchyRequestError: Иерархия дерева узлов неверна.
WrongDocumentError: Объект находится в неправильном Document. (Устаревшее значение кода: 4 и устаревшее имя константы: WRONG_DOCUMENT_ERR)
InvalidCharacterError: Строка содержит недопустимые символы.
NoModificationAllowedError: Объект не может быть изменён.
NotFoundError: Объект не найден здесь.
NotSupportedError: Операция не поддерживается.
InvalidStateError: Объект находится в недопустимом состоянии.
InUseAttributeError: Атрибут используется.
SyntaxError: Строка не соответствует ожидаемому шаблону.
InvalidModificationError: Объект не может быть изменён таким образом.
NamespaceError: Операция запрещена пространствами имён в XML.
InvalidAccessError: Объект не поддерживает операцию или аргумент.
TypeMismatchError Устаревший: Тип объекта не соответствует ожидаемому типу. (Устаревшее значение кода: 17 и устаревшее имя константы: TYPE_MISMATCH_ERR) Это значение устарело; вместо этого теперь генерируется исключение JavaScript TypeError, а не DOMException с этим значением.
SecurityError: Операция небезопасна.
NetworkError Экспериментальный: Произошла ошибка сети.
AbortError Экспериментальный: Операция была прервана.
URLMismatchError Экспериментальный: Указанный URL не соответствует другому URL.
QuotaExceededError Экспериментальный: Превышен лимит.
TimeoutError: Операция истекла.
InvalidNodeTypeError Экспериментальный: Узел неверен или имеет неверного предка для этой операции.
DataCloneError Экспериментальный: Объект не может быть клонирован.
EncodingError Экспериментальный: Операция кодирования/декодирования завершилась неудачно (нет устаревшего значения кода и имени константы).
NotReadableError Экспериментальный: Ошибка чтения входно/выходных данных (нет устаревшего значения кода и имени константы).
UnknownError Экспериментальный: Операция завершилась неудачей по неизвестной временной причине (например, недостаточно памяти) (нет устаревшего значения кода и имени константы).
ConstraintError Экспериментальный: Операция изменения в транзакции завершилась неудачей, так как ограничение не выполнено (нет устаревшего значения кода и имени константы).
DataError Экспериментальный: Предоставленные данные недостаточны (нет устаревшего значения кода и имени константы).
TransactionInactiveError Экспериментальный: Запрос был отправлен к транзакции, которая в настоящее время не активна или завершена (нет устаревшего значения кода и имени константы).
ReadOnlyError Экспериментальный: Операция изменения была предпринята в транзакции "только для чтения" (нет устаревшего значения кода и имени константы).
VersionError Экспериментальный: Была предпринята попытка открыть базу данных с более низкой версией, чем текущая (нет устаревшего значения кода и имени константы).
OperationError Экспериментальный: Операция завершилась неудачей по причине, специфичной для операции (нет устаревшего значения кода и имени константы).
NotAllowedError: Запрос не разрешен пользовательским агентом или платформой в текущем контексте, возможно, потому что пользователь отказал в разрешении (нет устаревшего значения кода и имени константы).

Спецификации

Спецификация
Web IDL # idl-DOMException

Совместимость с браузерами

	Настольные компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`DOMException`	46	79	37	33	10.1	46	37	33	10.3	5.0	46
`DOMException`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`code`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`message`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`name`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`serializable_object`	77	79	101	64	Нет	77	101	55	Нет	12.0	77

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMException