org.w3c.dom
クラス DOMException

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	code
static short	DOMSTRING_SIZE_ERR 指定されたテキスト範囲が DOMString 内に収まらない場合。
static short	HIERARCHY_REQUEST_ERR Node が所属先以外に挿入された場合。
static short	INDEX_SIZE_ERR インデックスまたはサイズが負の数または許容値より大きい場合。
static short	INUSE_ATTRIBUTE_ERR すでにほかで使用されている属性を追加しようとした場合。
static short	INVALID_ACCESS_ERR パラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。
static short	INVALID_CHARACTER_ERR XML 名などに不正な文字列、無効な文字列が指定された場合。
static short	INVALID_MODIFICATION_ERR 基本となるのオブジェクト型を変更しようとした場合。
static short	INVALID_STATE_ERR 使用できないオブジェクトを使用しようとした場合。
static short	NAMESPACE_ERR 不正な名前空間を使用してオブジェクトを作成または変更しようとした場合。
static short	NO_DATA_ALLOWED_ERR データをサポートしない Node に対してデータが指定された場合。
static short	NO_MODIFICATION_ALLOWED_ERR 変更が許可されていないオブジェクトを変更しようとした場合。
static short	NOT_FOUND_ERR コンテキスト内に存在しない Node を参照しようとした場合。
static short	NOT_SUPPORTED_ERR 実装が要求されたオブジェクト型または操作をサポートしていない場合。
static short	SYNTAX_ERR 不正な文字列、無効な文字列が指定された場合。
static short	TYPE_MISMATCH_ERR オブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。
static short	VALIDATION_ERR insertBefore や removeChild といったメソッドへの呼び出しで、「部分的有効性」の面で Node が無効になる場合は、この例外がスローされ、操作は完了しません。
static short	WRONG_DOCUMENT_ERR Node が作成元文書以外 (このノードをサポートしない文書) で使用された場合。

コンストラクタの概要

DOMException(short code, String message)

メソッドの概要

クラス java.lang.Throwable から継承されたメソッド

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールドの詳細

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_ERR

Node が所属先以外に挿入された場合。

関連項目:

定数フィールド値

WRONG_DOCUMENT_ERR

public static final short WRONG_DOCUMENT_ERR

Node が作成元文書以外 (このノードをサポートしない文書) で使用された場合。

関連項目:

定数フィールド値

INVALID_CHARACTER_ERR

public static final short INVALID_CHARACTER_ERR

XML 名などに不正な文字列、無効な文字列が指定された場合。

関連項目:

定数フィールド値

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

使用できないオブジェクトを使用しようとした場合。

導入されたバージョン:

DOM Level 2

関連項目:

定数フィールド値

SYNTAX_ERR

public static final short SYNTAX_ERR

不正な文字列、無効な文字列が指定された場合。

導入されたバージョン:

DOM Level 2

関連項目:

定数フィールド値

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR

基本となるのオブジェクト型を変更しようとした場合。

導入されたバージョン:

DOM Level 2

関連項目:

定数フィールド値

NAMESPACE_ERR

public static final short NAMESPACE_ERR

不正な名前空間を使用してオブジェクトを作成または変更しようとした場合。

導入されたバージョン:

DOM Level 2

関連項目:

定数フィールド値

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR

パラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。

導入されたバージョン:

DOM Level 2

関連項目:

定数フィールド値

VALIDATION_ERR

public static final short VALIDATION_ERR

insertBefore や removeChild といったメソッドへの呼び出しで、「部分的有効性」の面で Node が無効になる場合は、この例外がスローされ、操作は完了しません。このコードは「DOM Level 3 Validation」で使用されます。詳細については、この仕様を参照してください。

導入されたバージョン:

DOM Level 3

関連項目:

定数フィールド値

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR

オブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。

導入されたバージョン:

DOM Level 3

関連項目:

定数フィールド値

コンストラクタの詳細

DOMException

public DOMException(short code,
                    String message)