DOMException

DOMException 例外は、メソッドやプロパティを使用したときに異常なイベントが発生したことを表します。

コンストラクタ

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

属性

DOMException.code 読取専用
エラーコード定数の内の 1 つ、または該当しない場合に 0short 型の値で返します。このフィールドは歴史的な経緯で使用されており、新たな DOM 例外では使用しません。新たな例外の情報は DOMException.name 属性に収めています。
DOMException.name 読取専用
エラー定数に関連付けられた文字列のひとつを DOMString 型の値で返します。

エラーコード

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
ネットワークのエラーが発生しました。(レガシーコード: 19、レガシー定数名: NETWORK_ERR)
AbortError
操作が異常終了しました。(レガシーコード: 20、レガシー定数名: ABORT_ERR)
URLMismatchError
与えられた URL が、別の URL と一致しません。(レガシーコード: 21、レガシー定数名: URL_MISMATCH_ERR)
QuotaExceededError
クォータを超過しました。(レガシーコード: 22、レガシー定数名: QUOTA_EXCEEDED_ERR)
TimeoutError
操作がタイムアウトしました。(レガシーコード: 23、レガシー定数名: TIMEOUT_ERR)
InvalidNodeTypeError
ノードが正しくない、または操作に対して誤った祖先が存在します。(レガシーコード: 24、レガシー定数名: INVALID_NODE_TYPE_ERR)
DataCloneError
オブジェクトを複製できません。(レガシーコード: 25、レガシー定数名: DATA_CLONE_ERR)
EncodingError
エンコードやデコードといった、エンコーディング操作が失敗しました (レガシーコードおよびレガシー定数名はありません)。
NotReadableError
入出力の読み取り操作が失敗しました (レガシーコードおよびレガシー定数名はありません)。

仕様

仕様書 策定状況 コメント
Web IDL (Second Edition)
constructor の定義
勧告候補 DOMException クラスのコンストラクタを追加。値 NotReadableError を追加。
DOM4
DOMException の定義
草案 SECURITY_ERR, NETWORK_ERR, ABORT_ERR, URL_MISMATCH_ERR, QUOTA_EXCEEDED_ERR, TIMEOUT_ERR, INVALID_NODE_TYPE_ERR, DATA_CLONE_ERR を追加。例外値のプロパティ code を非推奨に変更。値 EncodingError を追加。
Document Object Model (DOM) Level 3 Core Specification
DOMException の定義
勧告 VALIDATION_ERR および TYPE_MISMATCH_ERR を追加。
Document Object Model (DOM) Level 2 Core Specification
DOMException の定義
勧告 INVALID_STATE_ERR, SYNTAX_ERR, INVALID_MODIFICATION_ERR, NAMESPACE_ERR, INVALID_ACCESS_ERR を追加。
Document Object Model (DOM) Level 1 Specification
DOMException の定義
勧告 最初期の定義

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) 1.0 (1.7 or earlier) ? ? ?
DOM Level 4 サポート (有) 13.0 (13.0) ? ? ?
DATA_CLONE_ERR 定数 (有) 5.0 (5.0) ? ? ?
コンストラクタ 未サポート ? ? ? ?
機能 Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
基本サポート ? (有) 1.0 (1.0) ? ? ? (有)
DOM Level 4 サポート ? (有) 13.0 (13.0) ? ? ? (有)
DATA_CLONE_ERR 定数 ? (有) 5.0 (5.0) ? ? ? (有)
コンストラクタ 未サポート 未サポート ? ? ? ? 未サポート

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: yyss, fscholz, jsx, ethertank, Potappo
 最終更新者: yyss,