Error

Le constructeur Error crée un objet représentant une erreur. Des instances d'objets Error sont levées lorsqu'une erreur d'exécution survient. L'objet Error peut aussi être utilisé comme objet de base (étendu ensuite) pour représenter des erreurs définies par l'utilisateur. Voir ci-dessous pour les différents types d'erreur natifs.

Syntaxe

new Error([message[, fileName[, lineNumber]]])

Paramètres

message

Description de l'erreur sous une forme compréhensible pour un humain

fileName

Paramètre optionnel, nom du fichier dont le code a levé l'exception. Par défaut, il s'agira du fichier contenant l'invocation du constructeur Error().

lineNumber

Paramètre optionnel, numéro de ligne dans le code à l'origine de l'exception. Par défaut, il s'agira de la ligne qui contient l'invocation du constructeur Error().

Description

Une erreur survenant pendant l'exécution du programme entraîne la création et la levée d'un objet Error.

Cette page ne se concentre que sur l'objet Error en tant que tel, ainsi que la manière de l'utiliser comme constructeur. La liste des propriétés et méthodes disponibles par héritage dans les instances de l'objet Error peut être trouvée sur la page Error.prototype.

Types d'erreur

Il existe, en plus du constructeur générique Error, six autres constructeurs d'erreurs natifs en JavaScript. Les exceptions causées par le client sont détaillées dans l'article sur la gestion des exceptions.

EvalError

Crée une instance d'une erreur survenue suite à l'utilisation de la fonction globale eval().

RangeError

Crée une instance d'erreur survenue suite à l'utilisation d'une variable numérique ou d'un paramètre hors de son intervalle de valeurs.

ReferenceError

Crée une instance d'erreur survenue suite au dé-référencement d'une référence invalide.

SyntaxError

Crée une instance d'erreur survenue suite à une erreur de syntaxe lors de la lecture du code par la fonction eval().

TypeError

Crée une instance d'erreur survenue lorsqu'une variable ou un paramètre n'est pas d'un type valide.

URIError

Crée une instance d'erreur survenue lors d'un passage de paramètres invalides aux fonctions encodeURI() ou decodeURI().

Propriétés

Error.prototype

Permet l'ajout de propriétés aux instances de l'objet Error.

Méthodes

L'objet global Error ne contient pas de méthodes en propre, mais il hérite de certaines méthodes par la chaine de prototype.

Instances de Error

Propriétés

Méthodes

Exemples

Lever une erreur générique

On utilisera le mot-clé throw pour lever une exception. L'erreur générée peut ensuite être « gérée » en utilisant l'instruction try...catch :

try {
    throw new Error("Ouups !");
} catch (e) {
    console.log(e.name + ": " + e.message);
}

Gérer une erreur spécifique

Vous pouvez choisir de ne gérer qu'un type bien spécifique d'erreur en vérifiant son type via la propriété constructor de l'erreur, ou, si vous utilisez plutôt des interpréteurs Javascript modernes, le mot-clé instanceof :

try {
    toto.truc();
} catch (e) {
    if (e instanceof EvalError) {
        console.log(e.name + ": " + e.message);
    } else if (e instanceof RangeError) {
        console.log(e.name + ": " + e.message);
    }
    // ... etc
}

Types d'erreur personnalisés

On peut avoir besoin de types d'erreur spécifiques, dérivés de Erreur pour pouvoir exécuter throw new MonErreur() et utiliser instanceof MonErreur afin de vérifier le type d'erreur lorsqu'on gère l'exception. La façon la plus courante pour créer un tel objet est présentée ci-dessous :

Sur ce sujet, voir aussi la page « Quelle est la meilleure façon d'étendre l'objet Error en JavaScript ? » sur Stack Overflow (en anglais).

function MonErreur(message) {
   this.message = message;
   var last_part = new Error().stack.match(/[^\s]+$/);
   this.stack = `${this.name} à ${last_part}`;
 }

MonErreur.prototype = Object.create(Error.prototype);
MonErreur.prototype.name = "MonErreur";
MonErreur.prototype.message = "";
MonErreur.prototype.constructor = MonErreur;

try {
  throw new MonErreur("Et encore une erreur");
} catch (e) {
  if (e instanceof MonErreur) {
    console.log(e.message);
  }
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• Error.prototype
• throw
• try...catch