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()
Retourne un objet DOMException avec un message et un nom spécifiés.

Propriétés

DOMException.code 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.
DOMException.message 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 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
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
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
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
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
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
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
Le temps est dépassé. (Valeur de code héritée : 23 et nom de la constante héritée : TIMEOUT_ERR)
InvalidNodeTypeError
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
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
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
L'opération de lecture entrée / sortie a échoué (Pas de valeur de code ni de nom de constante hérités).
UnknownError
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
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
Provided data is inadequate (No legacy code value and constant name).
TransactionInactiveError
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
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
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
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
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

Spécification Status Comment
Web IDL
La définition de 'constructor' dans cette spécification.
Candidat au statut de recommandation Ajout du constructeur pour la classe DOMException. Ajout des valeurs NotReadableError, UnknownError, ConstraintError, DataError, TransactionInactiveError, ReadOnlyError, VersionError, OperationError et NotAllowedError.
DOM4
La définition de 'DOMException' dans cette spécification.
Obsolete Ajout des SECURITY_ERR, NETWORK_ERR, ABORT_ERR, URL_MISMATCH_ERR, QUOTA_EXCEEDED_ERR, TIMEOUT_ERR, INVALID_NODE_TYPE_ERR, et DATA_CLONE_ERR. La propriété code a été dépréciée pour les valeurs d'exception. La valeur EncodingError ajoutée.
Document Object Model (DOM) Level 3 Core Specification
La définition de 'DOMException' dans cette spécification.
Obsolete Ajout de VALIDATION_ERR et TYPE_MISMATCH_ERR.
Document Object Model (DOM) Level 2 Core Specification
La définition de 'DOMException' dans cette spécification.
Obsolete Ajout de INVALID_STATE_ERR, SYNTAX_ERR, INVALID_MODIFICATION_ERR, NAMESPACE_ERR, and INVALID_ACCESS_ERR.
Document Object Model (DOM) Level 1 Specification
La définition de 'DOMException' dans cette spécification.
Obsolete Définition initiale.

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

           
Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui) (Oui) 1.0 (1.7 ou moins) ? ? ?
DOM Level 4 support (Oui) ? 13.0 (13.0) ? ? ?
DATA_CLONE_ERR constant (Oui) (Oui) 5.0 (5.0) ? ? ?
Constructor Pas de support Pas de support ? ? ? ?
           
Fonctionnalité Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Oui) (Oui) 1.0 (1.0) ? ? ? (Oui)
DOM Level 4 support ? (Oui) ? 13.0 (13.0) ? ? ? (Oui)
DATA_CLONE_ERR constant ? (Oui) (Oui) 5.0 (5.0) ? ? ? (Oui)
Constructor Pas de support Pas de support Pas de support ? ? ? ? Pas de support

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : loella16
 Dernière mise à jour par : loella16,