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()
Expérimental-
Retourne un objet
DOMException
avec un message et un nom spécifiés.
Propriétés
DOMException.code
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
. 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
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'exceptionTypeError
JavaScript est maintenant utilisée à la place d'uneDOMException
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