13.6.2.12 Eccezioni

Nuovo nella versione 2.1.

Le raccomandazioni DOM di livello 2 definiscono una singola eccezione, DOMException ed un certo numero di costanti che consentono alle applicazioni di determinare quale errore è intervenuto. Le istanze DOMException comunicano un attributo code che fornisce il valore appropriato per la specifica eccezione.

L'interfaccia DOM del Python fornisce le costanti, ma estende anche l'insieme delle eccezioni così da avere ogni specifica eccezione per ognuno dei codici di eccezione definiti dal DOM. L'implementazione deve sollevare l'eccezione di specifica appropriata, ognuna delle quali trasporta il valore appropriato per l'attributo code.

exception DOMException: Classe di eccezione di base usata per tutte le eccezioni DOM specificate. Questa classe di eccezioni non può essere istanziata direttamente.

exception DomstringSizeErr: Viene sollevata quando uno specifico intervallo di testo non entra in una stringa. Non si sa se sia usato nelle implementazioni DOM di Python, ma potrebbe essere ricevuto da implementazioni DOM non scritte in Python.

exception HierarchyRequestErr: Viene sollevata quando viene fatto un tentativo di inserire un nodo laddove il tipo di nodo non è consentito.

exception IndexSizeErr: Viene sollevata quando un indice o un parametro di dimensione verso un metodo è negativo o supera i valori ammessi.

exception InuseAttributeErr: Viene sollevata quando viene fatto un tentativo di inserire un nodo Attr che è già presente in un'altra parte del documento.

exception InvalidAccessErr: Viene sollevata se un parametro o una operazione non è supportata dall'oggetto sottostante.

exception InvalidCharacterErr: Questa eccezione viene sollevata quando un parametro di stringa che contiene caratteri che non sono permessi in quel particolare contesto, viene usata laddove sono in uso le raccomandazioni XML 1.0. Per esempio, tentare di creare un nodo Element con uno spazio nel nome del tipo di elemento causa che questo tipo di errore venga sollevato.

exception InvalidModificationErr: Viene sollevata quando viene effettuato un tentativo di modificare il tipo di un nodo.

exception InvalidStateErr: Viene sollevata quando viene fatto un tentativo di usare un oggetto che non è più usabile.

exception NamespaceErr: Se viene fatto un tentativo di cambiare un oggetto in un nodo che non è permesso dalle raccomandazioni per lo spazio dei nomi XML, viene sollevata questa eccezione.

exception NotFoundErr: Eccezione sollevata quando un nodo non esiste nel contesto a cui si riferisce. Per esempio, NamedNodeMap.removeNamedItem() solleverà questa eccezione se il nodo passato non esiste nella mappa.

exception NotSupportedErr: Viene sollevata quando l'implementazione non supporta l'oggetto del tipo richiesto o una particolare operazione.

exception NoDataAllowedErr: Questa eccezione viene sollevata se i dati sono specifici per un nodo che non supporta i dati stessi.

exception NoModificationAllowedErr: Viene sollevata nel tentativo di modificare un oggetto dove le modifiche non sono consentite (come per i nodi in sola lettura).

exception SyntaxErr: Viene sollevata quando viene specificata una stringa non valida o illegale.

exception WrongDocumentErr: Viene sollevata quando un nodo è inserito un un documento diverso da quello in uso, e l'implementazione non supporta la migrazione del nodo da un documento ad un altro.

I codici di eccezione definiti nella mappa delle raccomandazioni DOM sono di seguito descritti con le eccezioni collegate:

Costante Eccezione

DOMSTRING_SIZE_ERR DomstringSizeErr
HIERARCHY_REQUEST_ERR HierarchyRequestErr
INDEX_SIZE_ERR IndexSizeErr
INUSE_ATTRIBUTE_ERR InuseAttributeErr
INVALID_ACCESS_ERR InvalidAccessErr
INVALID_CHARACTER_ERR InvalidCharacterErr
INVALID_MODIFICATION_ERR InvalidModificationErr
INVALID_STATE_ERR InvalidStateErr
NAMESPACE_ERR NamespaceErr
NOT_FOUND_ERR NotFoundErr
NOT_SUPPORTED_ERR NotSupportedErr
NO_DATA_ALLOWED_ERR NoDataAllowedErr
NO_MODIFICATION_ALLOWED_ERR NoModificationAllowedErr
SYNTAX_ERR SyntaxErr
WRONG_DOCUMENT_ERR WrongDocumentErr

Costante	Eccezione
`DOMSTRING_SIZE_ERR`	`DomstringSizeErr`
`HIERARCHY_REQUEST_ERR`	`HierarchyRequestErr`
`INDEX_SIZE_ERR`	`IndexSizeErr`
`INUSE_ATTRIBUTE_ERR`	`InuseAttributeErr`
`INVALID_ACCESS_ERR`	`InvalidAccessErr`
`INVALID_CHARACTER_ERR`	`InvalidCharacterErr`
`INVALID_MODIFICATION_ERR`	`InvalidModificationErr`
`INVALID_STATE_ERR`	`InvalidStateErr`
`NAMESPACE_ERR`	`NamespaceErr`
`NOT_FOUND_ERR`	`NotFoundErr`
`NOT_SUPPORTED_ERR`	`NotSupportedErr`
`NO_DATA_ALLOWED_ERR`	`NoDataAllowedErr`
`NO_MODIFICATION_ALLOWED_ERR`	`NoModificationAllowedErr`
`SYNTAX_ERR`	`SyntaxErr`
`WRONG_DOCUMENT_ERR`	`WrongDocumentErr`

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.