Programmering

XML DOM - DOMException-objektet

Notifikationer til kerne DOM-objekter om undtagelser eller notifikationer.

Konstanter De nedenstående konstanter definerer egenskaberne for DOMException-objektet code

Gyldige værdier for egenskaben.Kommentar:

Disse konstanter er statiske egenskaber for DOMException, ikke egenskaber for individuelle undtagelsesobjekter.

Betyder, at der er opstået en fejl ved array- eller strengindeksoverskridelse.

DOMSTRING_SIZE_ERR

Betyder, at den anmodede tekst er for stor, og tekstens specificerede område passer ikke til DOMString.

HIERARCHY_REQUEST_ERR

Betyder, at der er forsøgt at placere en knude på en ulovlig placering i dokumenttreet.

WRONG_DOCUMENT_ERR

Betyder, at der er forsøgt at bruge en knude fra et dokument uden for det dokument, der har skabt knuden.

INVALID_CHARACTER_ERR

Betyder, at der er brugt ulovlige tegn (f.eks. i elementnavnet).

NO_DATA_ALLOWED_ERR

Angiver data for en Node, der ikke understøtter data.

NO_MODIFICATION_ALLOWED_ERR

Betyder, at der er forsøgt at ændre en skrivebeskyttet, ikke-tilpasselig knude.

NOT_FOUND_ERR

Betyder, at den ønskede knude ikke blev fundet på den forventede placering.

NOT_SUPPORTED_ERR

Betyder, at den aktuelle DOM-implementering ikke understøtter en bestemt egenskab eller metode.

INUSE_ATTRIBUTE_ERR

Betyder, at en Attr-knude allerede er tilknyttet en Element-knude, når der udføres en operation, der tilknytter en Attr-knude til en anden Element-knude.

INVALID_STATE_ERR

Beskriver brug af et objekt, der er i en tilstand, hvor det ikke længere er tilladt at bruge det.

SYNTAX_ERR

Beskriver den angivne fejl, der indeholder syntaksfejl. Bruges normalt med CSS-attributdeklarationer.

INVALID_MODIFICATION_ERR

Beskriver handlinger, der ændrer CSSRule-objektet eller CSSValue-objektet.

NAMESPACE_ERR

Beskriver fejl, der involverer elementer eller egenskaber i en navnerum.

INVALID_ACCESS_ERR

Beskriver adgang til objekt med en metode, der ikke understøttes af den aktuelle implementering.

code-egenskab

Fejlkode. Giver detaljerede oplysninger om årsagen til undtagelsen. De gyldige værdier (og deres betydninger) defineres af de konstanter, der er nævnt tidligere.

Beskrivelse

Når en DOM-egenskab eller -metode bruges forkert eller i et utilpasset miljø, vil der blive kastet en DOMException-objekt. Værdien af code-egenskaben beskriver den generelle type af den opståede undtagelse. Bemærk, at der kan kastes en DOMException-objekt, når der læses eller skrives til objektets egenskaber eller når der kaldes metoder på objektet.

I CodeW3C.coms XML DOM referencemanual er beskrivelsen af objektets egenskaber og metoder en liste over mulige undtagelser.

Bemærk, at ikke alle undtagelser i DOM meddeles af DOMException: Undtagelser, der involverer DOM Range-modulen, vil føre til udløsning af RangeException-undtagelse.