Programowanie

XML DOM - Obiekt DOMException

powiadamianie o wyjątkach lub powiadamianie o wyjątkach w głównej DOM.

stałe Poniższe stałe definiują code

Dopuszczalne wartości właściwości.Komentarz:

Te stałe są statycznymi właściwościami DOMException, a nie właściwościami pojedynczych obiektów wyjątków.

Opis sytuacji, w której doszło do błędu przepełnienia indeksu tablicy lub ciągu.

DOMSTRING_SIZE_ERR

Opis sytuacji, w której żądany tekst jest zbyt duży, a określony zakres tekstu nie pasuje do DOMString.

HIERARCHY_REQUEST_ERR

Opis sytuacji, w której dokonano operacji umieszczania węzła w niewłaściwej pozycji w hierarchii drzewa dokumentu.

WRONG_DOCUMENT_ERR

Opis sytuacji, w której operacja używania węzła z innego dokumentu niż dokument, z którego został utworzony, została wykonana.

INVALID_CHARACTER_ERR

Opis sytuacji, w której w (np. w nazwie elementu) użyto niewłaściwych znaków.

NO_DATA_ALLOWED_ERR

Przypisanie danych do Node, który nie obsługuje danych.

NO_MODIFICATION_ALLOWED_ERR

Opis sytuacji, w której dokonano operacji modyfikacji węzła, który jest niezmienialny i nie wolno go modyfikować.

NOT_FOUND_ERR

Opis sytuacji, w której nie znaleziono wymaganego węzła w oczekiwanym miejscu.

NOT_SUPPORTED_ERR

Opis sytuacji, w której bieżąca implementacja DOM nie obsługuje pewnej właściwości lub metody.

INUSE_ATTRIBUTE_ERR

Opis sytuacji, w której operacja przypisania Attr węzła do innego Element węzła została wykonana, gdy Attr węzeł jest już powiązany z innym Element węzłem.

INVALID_STATE_ERR

Opis użycia obiektu, który jest w stanie niedozwolonym lub nie dozwolonym do użycia.

SYNTAX_ERR

Opis błędu dotyczącego błędów gramatycznych w określonym błędzie. Zwykle używane w deklaracjach atrybutów CSS.

INVALID_MODIFICATION_ERR

Opis operacji na obiekcie CSSRule lub CSSValue.

NAMESPACE_ERR

Opis błędu dotyczącego błędów w nazwach przestrzeni elementów lub atrybutów.

INVALID_ACCESS_ERR

Opis dostępu do obiektu za pomocą metody, której bieżąca implementacja nie obsługuje.

Atrybut code

Kod błędu. Zapewnia szczegółowe informacje na temat przyczyny wystąpienia wyjątku. Legalne wartości (i ich znaczenie) tego atrybutu są zdefiniowane przez konstancje wymienione wcześniej.

Opis

Gdy używa się niewłaściwie lub w nieodpowiednim środowisku jakiejś właściwości lub metody DOM, zostaje wywołany obiekt DOMException. Wartość atrybutu code określa ogólny typ wystąpienia wyjątku. Uwaga, zarówno odczytywanie, jak i zapisywanie atrybutów obiektu, jak i wywoływanie metod obiektu, mogą wywołać obiekt DOMException.

W przewodniku XML DOM dostarczonym przez CodeW3C.com, sekcja opisująca atrybuty i metody obiektu wymienia możliwe do wywołania wyjątki.

Uwaga, nie wszystkie wyjątki w DOM są powiadomione przez DOMException: wyjątki dotyczące modułu DOM Range powodują wywołanie wyjątku RangeException.