ErrorNN 6 IE 5(Win) ECMA 3

Les navigateurs qui implémentent le traitement des exceptions try/catch créent automatiquement une instance de l´objet Error chaque fois qu´une erreur se produit pendant le traitement des scripts. Vous pouvez aussi créer une instance de l´objet Error que vous déclenchez explicitement. La partie catch de la construction try/catch reçoit l´instance de l´objet Error comme un paramètre, que les scripts peuvent passer en revue pour prendre connaissance des détails de l´erreur, telle qu´elle est présentée par les propriétés de l´objet.

 
Propriétés
 
constructordescriptionfileNamelineNumber
messagenamenumberprototype
 
Méthodes
 
toString()
 
Création d'un objet d´erreur
 
var myError = new Error("errorMessage");
constructorNN 6 IE 5(Win) ECMA 3

Lecture/écriture

Il s´agit d´une référence à la fonction qui a créé l´instance d´un objet Error: la fonction constructeur Error() d´origine dans les navigateurs.

 
Exemple
 
if (myVar.constructor == Error) {
    // process native string
}
 
Valeur

Référence de l´objet de fonction.

descriptionNN s.o. IE 5(Win) ECMA s.o.

Lecture/écriture

Fournit une description en clair de l´erreur, fréquemment la même que celle qui s´affiche dans la boîte de dialogue d´erreur de script de Microsoft Internet Explorer. Utilisez plutôt la propriété message plus récente.

 
Exemple
 
if (myError.description.indexOf("Object expected") != -1) {
    // handle "object expected" error
}
 
Valeur

Chaîne.

fileNameNN 6 IE s.o. ECMA s.o.

Lecture/écriture

Spécifie l´adresse URL de la page dans laquelle l´erreur de script s´est produite. Ces informations apparaissent dans la fenêtre Console JavaScript pour chaque erreur signalée.

 
Exemple
 
var sourceFile = myError.fileName;
 
Valeur

Chaîne URL.

lineNumberNN 6 IE s.o. ECMA s.o.

Lecture/écriture

Spécifie le numéro de la ligne du code source à laquelle l´erreur de script s´est produite. Ces informations apparaissent dans la fenêtre Console JavaScript pour chaque erreur signalée.

 
Exemple
 
var errorLine = myError.lineNumber;
 
Valeur

Nombre sous forme de chaîne.

messageNN 6 IE 5.5(Win) ECMA 3

Lecture/écriture

Fournit une description en clair de l´erreur. Il n´existe pas de norme pour le format ou le contenu de ces messages.

 
Exemple
 
if (myError.description.indexOf("defined") != -1) {
    // handle error for something being undefined
}
 
Valeur

Chaîne.

nameNN 6 IE 5.5(Win) ECMA 3

Lecture/écriture

Il s´agit d´une chaîne qui indique parfois le type de l´erreur considérée. La valeur par défaut de cette propriété est Error. Mais il est possible que le navigateur rapporte des types EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError et, si prise en charge par le navigateur, un type d´erreur du DOM W3C spécifique.

 
Exemple
 
if (myError.name == "SyntaxError") {
    // handle syntax error
}
 
Valeur

Chaîne.

numberNN s.o. IE 5(Win) ECMA s.o.

Lecture/écriture

Fournit un nombre correspondant à une erreur IE. Vous devez appliquer l´arithmétique binaire à la valeur pour obtenir un nombre qui signifie quelque chose. Utilisez:

var errNum = ErrObj.number& x0FFFF; 
 

Puis comparez le résultat à la liste des nombres de Microsoft sur http://msdn.microsoft.com/library/default.asp?url=/library/en-us/script56/html/js56jsmscRunTimeErrors.asp.

 
Exemple
 
var errNo = myError.number;
 
Valeur

Nombre.

prototypeNN 6 IE 5(Win) ECMA 3

Lecture/écriture

Propriété de l'objet Error statique. Utilisez la propriété prototype pour affecter de nouvelles propriétés et méthodes aux futures instances d´un objet d´erreur créées dans le document considéré. Pour des exemples, voir la description de la propriété Array.prototype.

 
Exemple
 
Error.prototype.custom = true;
 
Valeur

N´importe quelle donnée, y compris des références à des fonctions.

toString()NN 6 IE 5(Win) ECMA 3

Renvoie une représentation de l´objet sous forme de chaîne, mais les valeurs sont différentes selon la famille de navigateurs. IE renvoie [object Error], alors que Netscape 6 renvoie une concaténation des propriétés name et message.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.