Error | NN 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 | ||||||||
|
||||||||
Méthodes | ||||||||
|
||||||||
Création d'un objet d´erreur | ||||||||
var myError = new Error("errorMessage");
|
constructor | NN 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. |
description | NN 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. |
fileName | NN 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. |
lineNumber | NN 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. |
message | NN 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. |
name | NN 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. |
number | NN 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. |
prototype | NN 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. |