DOMException

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

現在の状況において、ユーザーエージェントまたはプラットフォームが要求を許可しませんでした。ユーザーが拒否されている可能性があります(古いコードおよび古い定数名はありません)。

仕様書

Specification
Web IDL Standard
# idl-DOMException

ブラウザーの互換性

BCD tables only load in the browser

関連情報