XML DOM - DOMException 對象

通知核心 DOM 對象的異常或通知。

常量

下面的常量定義了 DOMException 對象的 code 屬性的合法值。

注釋:這些常量是 DOMException 的靜態屬性,不是個別異常對象的屬性。

INDEX_SIZE_ERR

說明數組或字符串下標的溢出錯誤。

DOMSTRING_SIZE_ERR

說明請求的文本太大,文本的指定范圍不適合 DOMString。

HIERARCHY_REQUEST_ERR

說明發生了要把節點放在文檔樹層次中的不合法位置的操作。

WRONG_DOCUMENT_ERR

說明發生了從創建節點的文檔以外的文檔使用使用該節點的操作。

INVALID_CHARACTER_ERR

說明(比如在元素名中)使用了不合法的字符。

NO_DATA_ALLOWED_ERR

為不支持數據的 Node 指定數據。

NO_MODIFICATION_ALLOWED_ERR

說明發生了修改只讀的、不允許修改的節點的操作。

NOT_FOUND_ERR

說明在期望的位置沒有找到指定的節點

NOT_SUPPORTED_ERR

說明當前的 DOM 實現不支持某個屬性或方法。

INUSE_ATTRIBUTE_ERR

說明在一個 Attr 節點已經關聯到另一個 Element 節點時,發生了把一個 Attr 節點關聯到另一個 Element 節點的操作。

INVALID_STATE_ERR

說明使用了處于不允許使用狀態或不再允許使用狀態的對象。

SYNTAX_ERR

說明指定的錯誤含有語法錯誤。通常由 CSS 屬性聲明使用。

INVALID_MODIFICATION_ERR

說明發生了修改 CSSRule 對象或 CSSValue 對象的操作。

NAMESPACE_ERR

說明有涉及元素或屬性的命名空間的錯誤。

INVALID_ACCESS_ERR

說明以一種當前的實現不支持的方法訪問對象。

code 屬性

出錯代碼。提供了引發異常的原因的詳細情況。該屬性的合法值(和它們的含義)由前面列出的常量定義。

描述

當錯誤使用或在不適合的環境中使用某個 DOM 屬性或方法時,就會拋出一個 DOMException 對象。code 屬性的值說明了發生的異常的一般類型。注意,讀寫對象的屬性或調用對象的方法時,都有可能拋出 DOMException 對象。

在 CodeW3C.com 提供的 XML DOM 參考手冊中,對象的屬性和方法的描述部分列出了可能拋出的異常。

注意,并非 DOM 中的所有異常都由 DOMException 通知:涉及 DOM Range 模塊的異常,會導致拋出 RangeException 異常。