DOMException
DOMException
インターフェイスは、Web API のメソッドの呼び出しやプロパティへのアクセスによって異常なイベント (例外と呼ばれます) が発生したことを表します。これは基本的に、Web API 内部のエラーの状態を示すものです。
それぞれの例外に名称があり、これはエラーまたは異常な状態を特定する "CamelCase" 形式の文字列です。
コンストラクター
DOMException()
(en-US) Experimental-
指定したメッセージおよび名称の
DOMException
オブジェクトを返します。
プロパティ
DOMException.code
(en-US) 非推奨 読取専用-
エラーコード定数 の内の 1 つ、または該当しない場合に
0
をshort
型の値で返します。このフィールドは歴史的な経緯で使用されており、新たな DOM 例外では使用しません。新たな例外の情報はDOMException.name
属性に収めています。 DOMException.message
(en-US) 読取専用DOMException.name
読取専用
エラー名
これは、一般的なエラー名の一覧です。独自にエラー名のセットを定義している 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