【PHP8.x】codeプロパティの使い方
codeプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
dom\domexceptionクラスのcodeプロパティは、DOM操作中に発生したエラーの種類を示す数値コードを保持するプロパティです。このプロパティは、DOMExceptionオブジェクトが生成された際に、具体的なエラーの種類を特定するために設定されます。codeプロパティの値は、DOMExceptionインターフェースで定義されている定数のいずれかになります。
DOMExceptionインターフェースには、以下の定数が定義されており、codeプロパティの値として使用されます。
INDEX_SIZE_ERR: インデックスが範囲外の場合DOMSTRING_SIZE_ERR: 文字列が長すぎる場合HIERARCHY_REQUEST_ERR: ノードの挿入位置が不適切な場合WRONG_DOCUMENT_ERR: ノードが別のドキュメントに属している場合INVALID_CHARACTER_ERR: 無効な文字が使用された場合NO_DATA_ALLOWED_ERR: データが許可されていないノードに対してデータが設定されようとした場合NO_MODIFICATION_ALLOWED_ERR: ノードが変更を許可していない場合NOT_FOUND_ERR: ノードが見つからない場合NOT_SUPPORTED_ERR: 操作がサポートされていない場合INUSE_ATTRIBUTE_ERR: 属性がすでに使用されている場合INVALID_STATE_ERR: オブジェクトが無効な状態の場合SYNTAX_ERR: 無効な構文が使用された場合INVALID_MODIFICATION_ERR: 無効な変更が試みられた場合NAMESPACE_ERR: 名前空間に関するエラーが発生した場合INVALID_ACCESS_ERR: オブジェクトが使用をサポートしていない場合VALIDATION_ERR: 検証エラーが発生した場合TYPE_MISMATCH_ERR: 型が一致しない場合SECURITY_ERR: セキュリティ上のエラーが発生した場合NETWORK_ERR: ネットワークエラーが発生した場合ABORT_ERR: 操作が中止された場合URL_MISMATCH_ERR: URLが一致しない場合QUOTA_EXCEEDED_ERR: クォータを超過した場合TIMEOUT_ERR: タイムアウトが発生した場合NOT_ALLOWED_ERR: 許可されていない操作が試みられた場合
システムエンジニアは、このcodeプロパティの値を確認することで、DOM操作中に発生したエラーの原因を特定し、適切なエラーハンドリングを行うことができます。例えば、INDEX_SIZE_ERRが発生した場合、配列や文字列のインデックスが範囲外になっていないかを確認する必要があります。NOT_FOUND_ERRが発生した場合は、指定された要素が存在するかどうかを確認する必要があります。
構文(syntax)
1DOMException::$code
引数(parameters)
戻り値(return)
int
DOMExceptionクラスのcodeプロパティは、発生したDOMエラーの種類を示す整数値を返します。