java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.w3c.dom.DOMException
- すべての実装されたインタフェース:
Serializable
public class DOMException extends RuntimeException
DOM操作によって例外が発生するのは、ごく「例外的な」場合のみです。たとえば、論理上の問題、データの損失、実装の安定性の欠如などが原因で操作を実行できない場合にのみ、例外が発生します。 通常の処理状況では、DOMメソッドは例外ではなく、特定のエラー値を返します(
NodeList
の使用時における範囲外(out-of-bound)エラーなど)。
実装は、それ以外の状況でもさまざまな例外を返します。 たとえば、null
が予想されないときに、null
引数が渡されると、実装依存の例外が発生することもあります。
一部の言語システムおよびオブジェクト・システムは、例外の概念をサポートしていません。 このようなシステムでは、ネイティブのエラー・レポート・メカニズムによってエラー条件が示されます。 たとえば、一部のバインディングでは、メソッドが対応するメソッド記述に含まれているコードと同様のエラー・コードを返します。
「Document Object Model (DOM) Level 3 Core Specification」も参照してください。
- 関連項目:
- 直列化された形式
-
フィールドのサマリー
修飾子と型フィールド説明short
static short
指定されたテキスト範囲がDOMString
内に収まらない場合。static short
Node
が所属先以外に挿入された場合。static short
インデックスまたはサイズが負の数または許容値より大きい場合。static short
すでにほかで使用されている属性を追加しようとした場合。static short
パラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。static short
XML名などに不正な文字列、無効な文字列が指定された場合。static short
基本となるオブジェクト型を変更しようとした場合。static short
使用できないオブジェクトを使用しようとした場合。static short
不正な名前空間を使ってオブジェクトを作成または変更しようとした場合。static short
データをサポートしないNode
に対してデータが指定された場合。static short
変更が許可されていないオブジェクトを変更しようとした場合。static short
コンテキスト内に存在しないNode
を参照しようとした場合。static short
実装が要求されたオブジェクト型または操作をサポートしていない場合。static short
不正な文字列、無効な文字列が指定された場合。static short
オブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。static short
insertBefore
やremoveChild
といったメソッドへの呼出しで、「部分的有効性」の面でNode
が無効になる場合は、この例外がスローされ、操作は完了しません。static short
Node
が作成元文書以外(このノードをサポートしない文書)で使用された場合。 -
コンストラクタのサマリー
-
メソッドのサマリー
クラス java.lang.Throwableで宣言されたメソッド
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
フィールド詳細
-
code
public short code -
INDEX_SIZE_ERR
public static final short INDEX_SIZE_ERRインデックスまたはサイズが負の数または許容値より大きい場合。- 関連項目:
- 定数フィールド値
-
DOMSTRING_SIZE_ERR
public static final short DOMSTRING_SIZE_ERR指定されたテキスト範囲がDOMString
内に収まらない場合。- 関連項目:
- 定数フィールド値
-
HIERARCHY_REQUEST_ERR
public static final short HIERARCHY_REQUEST_ERRNode
が所属先以外に挿入された場合。- 関連項目:
- 定数フィールド値
-
WRONG_DOCUMENT_ERR
public static final short WRONG_DOCUMENT_ERRNode
が作成元文書以外(このノードをサポートしない文書)で使用された場合。- 関連項目:
- 定数フィールド値
-
INVALID_CHARACTER_ERR
public static final short INVALID_CHARACTER_ERRXML名などに不正な文字列、無効な文字列が指定された場合。- 関連項目:
- 定数フィールド値
-
NO_DATA_ALLOWED_ERR
public static final short NO_DATA_ALLOWED_ERRデータをサポートしないNode
に対してデータが指定された場合。- 関連項目:
- 定数フィールド値
-
NO_MODIFICATION_ALLOWED_ERR
public static final short NO_MODIFICATION_ALLOWED_ERR変更が許可されていないオブジェクトを変更しようとした場合。- 関連項目:
- 定数フィールド値
-
NOT_FOUND_ERR
public static final short NOT_FOUND_ERRコンテキスト内に存在しないNode
を参照しようとした場合。- 関連項目:
- 定数フィールド値
-
NOT_SUPPORTED_ERR
public static final short NOT_SUPPORTED_ERR実装が要求されたオブジェクト型または操作をサポートしていない場合。- 関連項目:
- 定数フィールド値
-
INUSE_ATTRIBUTE_ERR
public static final short INUSE_ATTRIBUTE_ERRすでにほかで使用されている属性を追加しようとした場合。- 関連項目:
- 定数フィールド値
-
INVALID_STATE_ERR
public static final short INVALID_STATE_ERR使用できないオブジェクトを使用しようとした場合。- 導入されたバージョン:
- 1.4、DOMレベル2
- 関連項目:
- 定数フィールド値
-
SYNTAX_ERR
public static final short SYNTAX_ERR不正な文字列、無効な文字列が指定された場合。- 導入されたバージョン:
- 1.4、DOMレベル2
- 関連項目:
- 定数フィールド値
-
INVALID_MODIFICATION_ERR
public static final short INVALID_MODIFICATION_ERR基本となるオブジェクト型を変更しようとした場合。- 導入されたバージョン:
- 1.4、DOMレベル2
- 関連項目:
- 定数フィールド値
-
NAMESPACE_ERR
public static final short NAMESPACE_ERR不正な名前空間を使ってオブジェクトを作成または変更しようとした場合。- 導入されたバージョン:
- 1.4、DOMレベル2
- 関連項目:
- 定数フィールド値
-
INVALID_ACCESS_ERR
public static final short INVALID_ACCESS_ERRパラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。- 導入されたバージョン:
- 1.4、DOMレベル2
- 関連項目:
- 定数フィールド値
-
VALIDATION_ERR
public static final short VALIDATION_ERRinsertBefore
やremoveChild
といったメソッドへの呼出しで、「部分的有効性」の面でNode
が無効になる場合は、この例外がスローされ、操作は完了しません。 このコードは「DOM Level 3 Validation」で使用されます。 詳細については、この仕様を参照してください。- 導入されたバージョン:
- 1.5、DOMレベル3
- 関連項目:
- 定数フィールド値
-
TYPE_MISMATCH_ERR
public static final short TYPE_MISMATCH_ERRオブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。- 導入されたバージョン:
- 1.5、DOMレベル3
- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
DOMException
public DOMException(short code, String message)
-