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
関連情報
DOMException
のポリフィルがcore-js
で利用できますDOMError