DOM - Oggetto DOMException
Il DOMException rappresenta un evento anomalo accade quando si utilizza un metodo o una proprietà.
Proprietà
La tabella sottostante elenca le proprietà dell'oggetto DOMException
| S.No. | Proprietà e descrizione |
|---|---|
| 1 | name Restituisce una stringa DOMString che contiene una delle stringhe associate a una costante di errore (come mostrato nella tabella seguente). |
Tipi di errore
| S.No. | Tipo e descrizione |
|---|---|
| 1 | IndexSizeError L'indice non è nell'intervallo consentito. Ad esempio, questo può essere lanciato dall'oggetto Range. (Valore del codice precedente: 1 e nome della costante precedente: INDEX_SIZE_ERR) |
| 2 | HierarchyRequestError La gerarchia dell'albero del nodo non è corretta. (Valore del codice precedente: 3 e nome della costante precedente: HIERARCHY_REQUEST_ERR) |
| 3 | WrongDocumentError L'oggetto è nel documento sbagliato. (Valore del codice precedente: 4 e nome della costante precedente: WRONG_DOCUMENT_ERR) |
| 4 | InvalidCharacterError La stringa contiene caratteri non validi. (Valore del codice precedente: 5 e nome della costante precedente: INVALID_CHARACTER_ERR) |
| 5 | NoModificationAllowedError L'oggetto non può essere modificato. (Valore del codice precedente: 7 e nome della costante precedente: NO_MODIFICATION_ALLOWED_ERR) |
| 6 | NotFoundError L'oggetto non può essere trovato qui. (Valore del codice precedente: 8 e nome della costante precedente: NOT_FOUND_ERR) |
| 7 | NotSupportedError L'operazione non è supportata. (Valore del codice precedente: 9 e nome della costante precedente: NOT_SUPPORTED_ERR) |
| 8 | InvalidStateError L'oggetto è in uno stato non valido. (Valore del codice precedente: 11 e nome della costante precedente: INVALID_STATE_ERR) |
| 9 | SyntaxError La stringa non corrisponde al modello previsto. (Valore del codice precedente: 12 e nome della costante precedente: SYNTAX_ERR) |
| 10 | InvalidModificationError L'oggetto non può essere modificato in questo modo. (Valore del codice precedente: 13 e nome della costante precedente: INVALID_MODIFICATION_ERR) |
| 11 | NamespaceError L'operazione non è consentita da Namespaces in XML. (Valore del codice precedente: 14 e nome della costante precedente: NAMESPACE_ERR) |
| 12 | InvalidAccessError L'oggetto non supporta l'operazione o l'argomento. (Valore del codice precedente: 15 e nome della costante precedente: INVALID_ACCESS_ERR) |
| 13 | TypeMismatchError Il tipo di oggetto non corrisponde al tipo previsto. (Valore del codice legacy: 17 e nome della costante legacy: TYPE_MISMATCH_ERR) Questo valore è deprecato, l'eccezione TypeError JavaScript viene ora sollevata invece di un'eccezione DOMException con questo valore. |
| 14 | SecurityError L'operazione è insicura. (Valore del codice precedente: 18 e nome della costante precedente: SECURITY_ERR) |
| 15 | NetworkError Si è verificato un errore di rete. (Valore del codice precedente: 19 e nome della costante precedente: NETWORK_ERR) |
| 16 | AbortError L'operazione è stata interrotta. (Valore del codice precedente: 20 e nome della costante precedente: ABORT_ERR) |
| 17 | URLMismatchError L'URL fornito non corrisponde a un altro URL. (Valore del codice precedente: 21 e nome della costante precedente: URL_MISMATCH_ERR) |
| 18 | QuotaExceededError La quota è stata superata. (Valore del codice precedente: 22 e nome della costante precedente: QUOTA_EXCEEDED_ERR) |
| 19 | TimeoutError L'operazione è scaduta. (Valore del codice precedente: 23 e nome della costante precedente: TIMEOUT_ERR) |
| 20 | InvalidNodeTypeError Il nodo non è corretto o ha un antenato errato per questa operazione. (Valore del codice precedente: 24 e nome della costante precedente: INVALID_NODE_TYPE_ERR) |
| 21 | DataCloneError L'oggetto non può essere clonato. (Valore del codice precedente: 25 e nome della costante precedente: DATA_CLONE_ERR) |
| 22 | EncodingError L'operazione di codifica, essendo una codifica o una decodifica, non è riuscita (nessun valore del codice legacy e nome della costante). |
| 23 | NotReadableError L'operazione di lettura di input / output non è riuscita (nessun valore del codice legacy e nome della costante). |
Esempio
L'esempio seguente mostra come l'utilizzo di un documento XML non ben formato provoca una DOMException.
I contenuti di error.xml sono i seguenti:
<?xml version = "1.0" encoding = "UTF-8" standalone = "no" ?>
<Company id = "companyid">
<Employee category = "Technical" id = "firstelement" type = "text/html">
<FirstName>Tanmay</first>
<LastName>Patil</LastName>
<ContactNo>1234567890</ContactNo>
<Email>[email protected]</Email>
</Employee>
</Company>L'esempio seguente dimostra l'utilizzo dell'attributo name :
<html>
<head>
<script>
function loadXMLDoc(filename) {
if (window.XMLHttpRequest) {
xhttp = new XMLHttpRequest();
} else // code for IE5 and IE6 {
xhttp = new ActiveXObject("Microsoft.XMLHTTP");
}
xhttp.open("GET",filename,false);
xhttp.send();
return xhttp.responseXML;
}
</script>
</head>
<body>
<script>
try {
xmlDoc = loadXMLDoc("/dom/error.xml");
var node = xmlDoc.getElementsByTagName("to").item(0);
var refnode = node.nextSibling;
var newnode = xmlDoc.createTextNode('That is why you fail.');
node.insertBefore(newnode, refnode);
} catch(err) {
document.write(err.name);
}
</script>
</body>
</html>Esecuzione
Salvare questo file come domexcption_name.html nel percorso del server (questo file e error.xml dovrebbero trovarsi sullo stesso percorso nel server). Otterremo l'output come mostrato di seguito -
TypeError