DOMException
============

L'interface **`DOMException`** représente un évènement anormal (appelé **exception**) qui appraît suite à l'appel d'une méthode ou à l'accès à une propriété d'une API web. C'est essentiellement lié à la façon dont les conditions d'erreur sont décrites dans les API web.

Chaque exception a un **nom**, qui est une courte chaîne identifiant l'erreur ou la condition anormale.

Constructeur
------------

`DOMException()` (en-US) 
Expérimental

Retourne un objet `DOMException` avec un message et un nom spécifiés.

Propriétés
----------

`DOMException.code` (en-US) 
Obsolète
 Lecture seule 

Renvoie un court message qui contient l'un des constantes de code d'erreur ou 0 si aucun ne correspond. Ce champ est utilisé pour des raisons historiques. Les nouvelles exceptions DOM ne l'utilisent plus : elles mettent cette information dans l'attribut `DOMException.name` (en-US).

`DOMException.message` (en-US) Lecture seule 

Returne une `DOMString` (*chaîne de caractères*) représentant un message ou une description associé avec le nom d'erreur donné.

`DOMException.name` (en-US) Lecture seule 

Retourne une `DOMString` (*chaîne de caractères*) qui contient l'une des chaînes associées à un nom d'erreur.

Noms d'erreur
-------------

Les noms d'erreurs courants sont répertoriés ici. Certaines API définissent leurs propres ensembles de noms, il ne s'agit donc pas ici nécessairement d'une liste complète.

**Note :** Parce qu'historiquement les erreurs ont été identifiées par une valeur numérique qui correspondait à une variable nommée définie pour avoir cette valeur, certaines des entrées ci-dessous indiquent la valeur de code héritée et le nom de constante qui ont été utilisés dans le passé.

`IndexSizeError`

L'index n'est pas dans la plage autorisée. Par exemple, cela peut être lancé par un objet `Range`. (Valeur de code héritée : `1` et nom de la constante héritée : `INDEX_SIZE_ERR`)

`HierarchyRequestError`

La hiérarchie de l'arborescence des nœuds est incorrecte. ( Valeur de code héritée : `3` et nom de la constante héritée : `HIERARCHY_REQUEST_ERR`)

`WrongDocumentError`

L'objet est dans le mauvais `Document`. ( Valeur de code héritée : `4` et nom de la constante héritée : `WRONG_DOCUMENT_ERR`)

`InvalidCharacterError`

La chaîne contient des caractères non valides. (Valeur de code héritée : `5` et nom de la constante héritée : `INVALID_CHARACTER_ERR`)

`NoModificationAllowedError`

L'objet ne peut être modifié. (Valeur de code héritée : `7` et nom de la constante héritée : `NO_MODIFICATION_ALLOWED_ERR`)

`NotFoundError`

L'objet ne peut être trouvé ici. (Valeur de code héritée : `8` et nom de la constante héritée : `NOT_FOUND_ERR`)

`NotSupportedError`

L'opération n'est pas supportée. (Valeur de code héritée : `9` et nom de la constante héritée : `NOT_SUPPORTED_ERR`)

`InvalidStateError`

L'objet est dans un état non valide. (Valeur de code héritée : `11` et nom de la constante héritée : `INVALID_STATE_ERR`)

`SyntaxError`

La chaîne ne correspond pas au modèle attendu. (Valeur de code héritée : `12` et nom de la constante héritée : `SYNTAX_ERR`)

`InvalidModificationError`

L'objet ne peut pas être modifié de cette manière. (Valeur de code héritée : `13` et nom de la constante héritée : `INVALID_MODIFICATION_ERR`)

`NamespaceError`

L'opération n'est pas autorisée par Namespaces en XML. (Valeur de code héritée : `14` et nom de la constante héritée : `NAMESPACE_ERR`)

`InvalidAccessError`

L'objet ne prend pas en charge l'opération ou l'argument. (Valeur de code héritée : `15` et nom de la constante héritée : `INVALID_ACCESS_ERR`)

`TypeMismatchError` 
Obsolète

Le type de l'objet ne correspond pas au type attendu. (Valeur de code héritée : `17` et nom de la constante héritée : `TYPE_MISMATCH_ERR`). Cette valeur est dépéciée, l'exception `TypeError` JavaScript est maintenant utilisée à la place d'une `DOMException` avec cette valeur.

`SecurityError` 
Expérimental

L'opération n'est pas sécurisée. (Valeur de code héritée : `18` et nom de la constante héritée : `SECURITY_ERR`)

`NetworkError` 
Expérimental

Une erreur réseau s'est produite. (Valeur de code héritée : `19` et nom de la constante héritée : `NETWORK_ERR`)

`AbortError` 
Expérimental

L'opération a été annulée (Valeur de code héritée : `20` et nom de la constante héritée : `ABORT_ERR`)

`URLMismatchError` 
Expérimental

L'URL donnée ne correspond pas à une autre URL. (Valeur de code héritée : `21` et nom de la constante héritée : `URL_MISMATCH_ERR`)

`QuotaExceededError` 
Expérimental

Le quota a été dépassé. (Valeur de code héritée : `22` et nom de la constante héritée : `QUOTA_EXCEEDED_ERR`)

`TimeoutError` 
Expérimental

Le temps est dépassé. (Valeur de code héritée : `23` et nom de la constante héritée : `TIMEOUT_ERR`)

`InvalidNodeTypeError` 
Expérimental

Le noeud est incorrect ou a un ancêtre incorrect pour cette opération. (Valeur de code héritée : `24` et nom de la constante héritée : `INVALID_NODE_TYPE_ERR`)

`DataCloneError` 
Expérimental

L'objet ne peut pas être cloné. ( Valeur de code héritée : `25` et nom de la constante héritée : `DATA_CLONE_ERR`)

`EncodingError` 
Expérimental

L'opération de codage ou de décodage a échoué (Pas de valeur de code ni de nom de constante hérités).

`NotReadableError` 
Expérimental

L'opération de lecture entrée / sortie a échoué (Pas de valeur de code ni de nom de constante hérités).

`UnknownError` 
Expérimental

L'opération a échoué pour une raison transitoire inconnue (par exemple dépassement de mémoire) (Pas de valeur de code ni de nom de constante hérités) .

`ConstraintError` 
Expérimental

Une opération de mutation dans une transaction a échoué car une contrainte n'a pas été satisfaite (Pas de valeur de code ni de nom de constante hérités) .

`DataError` 
Expérimental

Provided data is inadequate (No legacy code value and constant name).

`TransactionInactiveError` 
Expérimental

Une demande a été placée contre une transaction qui n'est actuellement pas active ou qui est terminée (Pas de valeur de code ni de nom de constante hérités).

`ReadOnlyError` 
Expérimental

L'opération de mutation a été tentée dans une transaction "en lecture seule" (Pas de valeur de code ni de nom de constante hérités).

`VersionError` 
Expérimental

Une tentative a été faite pour ouvrir une base de données en utilisant une version inférieure à la version existante (Pas de valeur de code ni de nom de constante hérités).

`OperationError` 
Expérimental

L'opération a échoué pour une raison spécifique à l'opération (Pas de valeur de code ni de nom de constante hérités).

`NotAllowedError` 
Expérimental

La demande n'est pas autorisée par l'agent utilisateur ou la plateforme dans le contexte actuel, peut-être parce que l'utilisateur a refusé la permission (Pas de valeur de code ni de nom de constante hérités).

Spécifications
--------------

| Specification |
| --- |
| Web IDL Standard # idl-DOMException |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `DOMError`