DOMException

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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'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 # idl-DOMException

Compatibilité des navigateurs

Voir aussi

DOMError

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨17 déc. 2024⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content