Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

ReferenceError — références de variables invalides

ReferenceError est un type d’erreur JavaScript intégré, déclenché notamment lors de la lecture d’un nom non résolu ou d’une variable avant son initialisation. Découvrez en quoi une variable manquante diffère de undefined et pourquoi typeof ne contourne pas les règles d’initialisation.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new ReferenceError(message)
ReferenceError(message)

ReferenceError est un type d’erreur ECMAScript intégré qui hérite de Error ; ce n’est pas une API Web. Le moteur le déclenche notamment lorsqu’un identifiant lu ne correspond à aucune liaison accessible, par exemple à cause d’une faute de frappe ou de l’utilisation d’un nom hors de sa portée. Une variable déclarée et initialisée dont la valeur est undefined n’est pas équivalente à une liaison manquante.

La lecture d’une variable déclarée avec let ou const avant son initialisation déclenche également un ReferenceError. Cet intervalle est appelé temporal dead zone (TDZ). L’opérateur typeof renvoie "undefined" pour un nom non résolu, mais ne contourne pas la TDZ : typeof value avant l’initialisation d’un let value local déclenche une erreur. En revanche, la lecture ordinaire d’une propriété manquante sur un objet ordinaire renvoie undefined, et non ReferenceError.

new ReferenceError(message) crée un objet erreur ; l’appel ReferenceError(message) sans new est également autorisé. L’argument message est facultatif. Créer l’objet ne déclenche pas l’erreur : il faut pour cela utiliser throw. Utilisez try...catch pour gérer les erreurs attendues, mais corrigez à la source les fautes de frappe et les erreurs d’ordre d’initialisation. La formulation exacte des messages générés par le moteur peut varier selon les implémentations.

Exemples

(() => {
  try {
    console.log(typeof value);
    let value = 42;
  } catch (error) {
    console.log(error instanceof ReferenceError);
    console.log(error.name);
  }

  const custom = new ReferenceError("Missing binding");
  console.log(custom.message);
})();

Résultat

true
ReferenceError
Missing binding

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources