DOMException

DOMException インターフェイスは、Web API のメソッドの呼び出しやプロパティへのアクセスによって異常なイベント (例外と呼ばれます) が発生したことを表します。これは基本的に、Web API 内部のエラーの状態を示すものです。

それぞれの例外に名称があり、これはエラーまたは異常な状態を特定する "CamelCase" 形式の文字列です。

コンストラクター

DOMException() (en-US) Experimental

指定したメッセージおよび名称の DOMException オブジェクトを返します。

プロパティ

DOMException.code (en-US) 非推奨 読取専用

エラーコード定数 の内の 1 つ、または該当しない場合に 0short 型の値で返します。このフィールドは歴史的な経緯で使用されており、新たな DOM 例外では使用しません。新たな例外の情報は DOMException.name 属性に収めています。

DOMException.message (en-US) 読取専用

指定した エラー名 に関連付けられたメッセージまたは説明を表す DOMString を返します。

DOMException.name 読取専用

エラー名 に関連付けられた文字列のひとつを DOMString 型の値で返します。

エラー名

これは、一般的なエラー名の一覧です。独自にエラー名のセットを定義している API がありますので、これは必ずしも完全なリストではありません。

メモ: 歴史的にエラーは、エラーの値を持つように定義した名前付き変数と、それに対応する値で識別されてきたため、一部の項目では過去に使用されたレガシーコードや定数名も記載します。

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)

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

関連情報