Προγραμματισμός

XML DOM - Αντικείμενο DOMException

Ειδοποιούν τα κεντρικά αντικείμενα DOM για εξαιρέσεις ή για ειδοποιήσεις.

Συνθήκες Οι παρακάτω συνθήκες καθορίζουν τις τιμές των αντικειμένων DOMException: code

Νόμιμες τιμές των ιδιοτήτων.Σημείωση:

Αυτές οι συνθήκες είναι στατικές ιδιότητες της DOMException, και όχι ιδιότητες εξαιρετικών αντικειμένων.

Εξηγείται ότι έχει συμβεί σφάλμα υπερβολής του δείκτη του αριθμητικού ή της αλφαβητικής σειράς.

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 όταν έχει ήδη συνδεθεί σε έναν άλλο κόμβο Element.

INVALID_STATE_ERR

Περιγραφή. Χρήση αντικειμένων που βρίσκονται σε κατάσταση που δεν επιτρέπεται η χρήση τους ή που δεν επιτρέπεται πλέον η χρήση τους.

SYNTAX_ERR

Περιγραφή. Σφάλμα γραμματικής στο καθορισμένο σφάλμα. Γενικά προκαλείται από την χρήση της δήλωσης CSS ιδιοτήτων.

INVALID_MODIFICATION_ERR

Περιγραφή. Εκτέλεση ενέργειας που αφορά το CSSRule όντος ή το CSSValue όντος.

NAMESPACE_ERR

Περιγραφή. Σφάλμα στο όνομα του στοιχείου ή της ιδιότητας που περιλαμβάνει το ονοματικό χώρο.

INVALID_ACCESS_ERR

Περιγραφή. Επιστροφή του αντικειμένου με τρόπο που δεν υποστηρίζεται από την τρέχουσα υλοποίηση.

Ιδιότητα code

Κώδικας σφάλματος. Παρέχει λεπτομερείς πληροφορίες για την αιτία που προκάλεσε την εξαίρεση. Οι νόμιμες τιμές (και το εννοιολογικό τους περιεχόμενο) ορίζονται από τις παραπάνω αναφερόμενες σταθερές.

Περιγραφή

Όταν χρησιμοποιείται λάθος ή σε περιβάλλον που δεν είναι κατάλληλο μια ιδιότητα ή μέθοδος DOM, θα εκτοξευθεί ένα αντικείμενο DOMException. Η τιμή της ιδιότητας code περιγράφει τον τύπο της γενικής εξαιρέσης που έχει συμβεί. Σημείωση, η ανάγνωση ή η εγγραφή ιδιοτήτων του αντικειμένου ή η κλήση μεθόδων του αντικειμένου μπορεί να προκαλέσει την εκτόξευση του αντικειμένου DOMException.

Στο εγχειρίδιο αναφοράς XML DOM που παρέχει το CodeW3C.com, η περιγραφή των ιδιοτήτων και των μεθόδων του αντικειμένου αναφέρεται στις πιθανές εξαιρέσεις που μπορεί να προκύψουν.

Σημείωση, όχι όλες οι εξαιρέσεις του DOM ανακοινώνονται από το DOMException: οι εξαιρέσεις που σχετίζονται με το μοτίβο DOM Range προκαλούν την εκτόξευση της εξαιρέσης RangeException.