name, propriété
Mise à jour : novembre 2007
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. Cela 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 de codage ou de décodage. |
Exemple
L'exemple suivant lève une exception et affiche l'erreur ainsi que sa description.
function getAge(age) {
if(age < 0)
throw new Error("An age cannot be negative.")
print("Age is "+age+".");
}
// Pass the getAge an invalid argument.
try {
getAge(-5);
} catch(e) {
print(e.name);
print(e.description);
}
Le résultat généré par ce code est le suivant :
Error
An age cannot be negative.