Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

ReferenceError

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 (en-US)
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

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ReferenceError/prototype','Properties')}}

Méthodes

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ReferenceError/prototype','M.C3.A9thodes')}}

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
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'ReferenceError' dans cette spécification.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'ReferenceError' dans cette spécification.		 Standard  
ECMAScript (ECMA-262)
La définition de 'ReferenceError' dans cette spécification.		 Standard évolutif  

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi