mozilla

ReferenceError

Résumé

L'objet ReferenceError représente une erreur qui se produit lorsqu'il est fait référence à une variable qui n'existe pas.

Syntaxe

new ReferenceError([message[, nomFichier[, numLigne]]])

Paramètres

message
Paramètre optionnel. Une description de l'erreur, lisible par un être humain.
nomFichier
Paramètre optionnel. Le nom du fichier qui contient le code à l'origine de l'exception.
numLigne
Paramètre optionnel. Le numéro de ligne dans le fichier qui contient le code à l'origine de l'exception.

Description

Une exception ReferenceError est lancée quand on tente de faire référence à une variable qui n'a pas été déclarée.

Propriétés

ReferenceError.prototype
Cette propriété permet d'ajouter des propriétés à un objet ReferenceError.

Méthodes

L'objet global ReferenceError ne contient aucune méthode qui lui soit propre. En revanche, il hérite de certaines méthodes via l'héritage et sa chaîne de prototypes.

Instances de ReferenceError

Propriétés

ReferenceError.prototype.constructor
Définit la fonction utilisée pour créer une instance du prototype.
ReferenceError.prototype.message
Le message de l'erreur. Bien que ECMA-262 spécifie que ReferenceError devrait posséder une propriété message en propre, SpiderMonkey lui fait hériter de Error.prototype.message.
ReferenceError.prototype.name
Le nom de l'erreur. Cette propriété est héritée depuis Error.
ReferenceError.prototype.fileName
Le chemin du fichier à l'origine de cette erreur. Cette propriété est héritée depuis Error.
ReferenceError.prototype.lineNumber
Le numéro de la ligne dans le fichier à l'origine de l'erreur. Cette propriété est héritée depuis Error.
ReferenceError.prototype.columnNumber
Le numéro de la colonne parmi la ligne à l'origine de l'erreur. Cette propriété est héritée depuis Error.
ReferenceError.prototype.stack
La pile d'appels, héritée de Error.

Méthodes

Bien que l'objet prototype pour ReferenceError ne contienne aucune méthode propre, les instances de ReferenceError héritent de certaines méthodes via la chaîne de prototypes.

Exemples

Intercepter une exception ReferenceError

try {
  var a = variableNonDéfinie;
} catch (e) {
  console.log(e instanceof ReferenceError); // true
  console.log(e.message);                   // "variableNonDéfinie is not defined"
  console.log(e.name);                      // "ReferenceError"
  console.log(e.fileName);                  // "Scratchpad/1"
  console.log(e.lineNumber);                // 2
  console.log(e.columnNumber);              // 6
  console.log(e.stack);                     // "@Scratchpad/2:2:7\n"
}

Créer une exception ReferenceError

try {
  throw new ReferenceError('Bonjour', 'unFichier.js', 10);
} catch (e) {
  console.log(e instanceof ReferenceError); // true
  console.log(e.message);                   // "Bonjour"
  console.log(e.name);                      // "ReferenceError"
  console.log(e.fileName);                  // "unFichier.js"
  console.log(e.lineNumber);                // 10
  console.log(e.columnNumber);              // 0
  console.log(e.stack);                     // "@Scratchpad/2:2:9\n"
}

Spécifications

Spécification Statut Commentaires
Troisième édition d'ECMAScript. Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'ReferenceError' dans cette spécification.
Standard  
ECMAScript 6 (ECMA-262)
La définition de 'ReferenceError' dans cette spécification.
Draft  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,