Partager via


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

Configuration requise

Version 5.5

S'applique à :

Error, objet

Voir aussi

Référence

description, propriété

Propriété message (Visual Studio - JScript)

number, propriété