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) Experimental-
Retourne un objet
DOMException
avec un message et un nom spécifiés.
Propriétés
DOMException.code
(en-US) Deprecated 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
Deprecated-
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'exceptionTypeError
JavaScript est maintenant utilisée à la place d'uneDOMException
avec cette valeur. SecurityError
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
Le temps est dépassé. (Valeur de code héritée :
23
et nom de la constante héritée :TIMEOUT_ERR
) InvalidNodeTypeError
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
L'opération de lecture entrée / sortie a échoué (Pas de valeur de code ni de nom de constante hérités).
UnknownError
Experimental-
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
Experimental-
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
Experimental-
Provided data is inadequate (No legacy code value and constant name).
TransactionInactiveError
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
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
Experimental-
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
BCD tables only load in the browser