DOMException

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

DOMException インターフェイスは、Web API のメソッドの呼び出しやプロパティへのアクセスによって異常なイベント（例外と呼ばれます）が発生したことを表します。これは基本的に、Web 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: ノードツリーの階層が正しくありません。（古いコード: 3、古い定数名: HIERARCHY_REQUEST_ERR）
WrongDocumentError: オブジェクトが誤った Document 内に存在します。（古いコード: 4、古い定数名: WRONG_DOCUMENT_ERR）
InvalidCharacterError: 文字列に無効な文字が含まれています。（古いコード: 5、古い定数名: INVALID_CHARACTER_ERR）
NoModificationAllowedError: オブジェクトを変更できません。（古いコード: 7、古い定数名: NO_MODIFICATION_ALLOWED_ERR）
NotFoundError: オブジェクトが見つかりません。（古いコード: 8、古い定数名: NOT_FOUND_ERR）
NotSupportedError: 操作をサポートしていません。（古いコード: 9、古い定数名: NOT_SUPPORTED_ERR）
InvalidStateError: オブジェクトが無効な状態です。（古いコード: 11、古い定数名: INVALID_STATE_ERR）
InUseAttributeError: 属性が使用中です。（古いコード: 10、古い定数名: INUSE_ATTRIBUTE_ERR）
SyntaxError: 文字列が期待されたパターンに一致しません。（古いコード: 12、古い定数名: SYNTAX_ERR）
InvalidModificationError: オブジェクトをこの方法で変更できません。（古いコード: 13、古い定数名: INVALID_MODIFICATION_ERR）
NamespaceError: XML の名前空間によって、操作は許可されていません。（古いコード: 14、古い定数名: NAMESPACE_ERR）
InvalidAccessError: オブジェクトが操作や引数をサポートしていません。（古いコード: 15、古い定数名: INVALID_ACCESS_ERR）
TypeMismatchError 非推奨;: オブジェクトの型が、期待された型に一致しません。（古いコード: 17、古い定数名: TYPE_MISMATCH_ERR）この値は非推奨です。この値を持つ DOMException に代わり JavaScript の TypeError 例外が発生するようになりました。
SecurityError: 操作が安全ではありません。（古いコード: 18、古い定数名: SECURITY_ERR）
NetworkError Experimental: ネットワークのエラーが発生しました。（古いコード: 19、古い定数名: NETWORK_ERR）
AbortError Experimental: 操作が異常終了しました。（古いコード: 20、古い定数名: ABORT_ERR）
URLMismatchError Experimental: 与えられた URL が、別の URL と一致しません。（古いコード: 21、古い定数名: URL_MISMATCH_ERR）
QuotaExceededError Experimental: クォータを超過しました。（古いコード: 22、古い定数名: QUOTA_EXCEEDED_ERR）
TimeoutError: 操作がタイムアウトしました。（古いコード: 23、古い定数名: TIMEOUT_ERR）
InvalidNodeTypeError Experimental: ノードが正しくない、または操作に対して誤った祖先が存在します。（古いコード: 24、古い定数名: INVALID_NODE_TYPE_ERR）
DataCloneError Experimental: オブジェクトを複製できません。（古いコード: 25、古い定数名: DATA_CLONE_ERR）
EncodingError Experimental: エンコードやデコードといった、エンコーディング操作が失敗しました（古いコードおよび古い定数名はありません）。
NotReadableError Experimental: 入出力の読み取り操作が失敗しました（古いコードおよび古い定数名はありません）。
UnknownError Experimental: 未知の一時的な理由 (例えばメモリー不足) によって、操作が失敗しました（古いコードおよび古い定数名はありません）。
ConstraintError Experimental: 制約が満たされないため、処理の中の変更操作が失敗しました（古いコードおよび古い定数名はありません）。
DataError Experimental: 提供されたデータが不適切です（古いコードおよび古い定数名はありません）。
TransactionInactiveError Experimental: 現在アクティブではない、または終了した処理に対して要求を行いました（古いコードおよび古い定数名はありません）。
ReadOnlyError Experimental: 「読み取り専用」の処理で変更操作を試みました（古いコードおよび古い定数名はありません）。
VersionError Experimental: 現在のバージョンより古いバージョンを使用するデータベースを開こうとしました（古いコードおよび古い定数名はありません）。
OperationError Experimental: 操作に固有の理由で、操作が失敗しました（古いコードおよび古い定数名はありません）。
NotAllowedError: 現在の状況において、ユーザーエージェントまたはプラットフォームが要求を許可しませんでした。ユーザーが拒否されている可能性があります（古いコードおよび古い定数名はありません）。