name, propriété
Retourne le nom d'une erreur.
errorObj.name
Arguments
- errorObj
Obligatoire. Instance d'un objet Error.
Notes
La propriété name retourne le nom ou le type d'exception d'une erreur. Lorsqu'une erreur d'exécution se produit, la propriété name prend l'un des types d'exception natifs suivants :
Type d'exception |
Signification |
|---|---|
Erreur |
Cette erreur est une erreur définie par l'utilisateur, créée à l'aide du constructeur d'objet Error. |
ConversionError |
Cette erreur se produit lorsque vous essayez d'effectuer une conversion impossible à réaliser pour un objet. |
RangeError |
Cette erreur se produit lorsqu'une fonction est spécifiée avec un argument qui est en dehors de la plage de sélection autorisée. Elle se produit, par exemple, si vous tentez de créer un objet Array avec une longueur définie par une valeur autre qu'un entier positif. |
ReferenceError |
Cette erreur se produit en présence d'une référence non valide. Elle se produit, par exemple, lorsque la référence attendue a la valeur null. |
RegExpError |
Cette erreur se produit en présence d'une erreur de compilation avec une expression régulière. Toutefois, une fois que l'expression régulière est compilée, cette erreur ne peut plus se produire. Ceci peut arriver, par exemple, lorsqu'une expression régulière est déclarée avec un modèle comportant une syntaxe non valide, avec des indicateurs autres que i, g ou m, ou si le même indicateur est défini plusieurs fois. |
SyntaxError |
Cette erreur se produit lorsque le texte source est analysé et que sa syntaxe est incorrecte. Elle se produit, par exemple, si la fonction eval est appelée avec un argument ne constituant pas un texte de programme correct. |
TypeError |
Cette erreur se produit lorsque le type réel d'opérande ne correspond pas au type attendu. Ce peut être le cas, par exemple, lorsqu'un appel de fonction est effectué sur un élément autre qu'un objet ou ne gérant pas l'appel. |
URIError |
Cette erreur se produit lorsqu'un indicateur URI (Uniform Resource Indicator) non conforme a été détecté. Elle se produit, par exemple, lorsqu'un caractère non conforme est trouvé dans une chaîne en cours d'encodage ou de décodage. |
Exemple
Dans l'exemple suivant, une exception est levée et l'erreur ainsi que sa description s'affichent.
try
{
var arr = new Array(-1);
}
catch(e)
{
print ("Error Message: " + e.message);
print ("Error Code: " + (e.number & 0xFFFF))
print ("Error Name: " + e.name);
}
La sortie de ce code est la suivante.
Error Message: Array length must be zero or a positive integer
Error Code: 5029
Error Name: RangeError