Le constructeurError permet de créer un objet représentant une erreur.

Syntaxe

new Error();new Error(message);new Error(message, options);new Error(message, nomFichier);new Error(message, nomFichier, numeroLigne);

Paramètres

messageFacultatif

Une description de l'erreur, compréhensible par un humain.

optionsFacultatif

Un objet avec les propriétés suivantes :

causeFacultatif

Une propriété qui indique la cause spécifique de l'erreur. Lors de l'interception puis du renvoi d'une erreur avec un autre message d'erreur, cette propriété devrait être utilisée afin de transmettre le message d'erreur original.

nomFichierFacultatifNon standard

La valeur de la propriéténomFichier pour l'objetError créé. Par défaut, il s'agit du nom du fichier contenant le code qui a invoqué le constructeurError().

numeroLigneFacultatifNon standard

La valeur de la propriéténumeroLigne pour l'objetError créé. Par défaut, il s'agit du numéro de ligne du fichier contenant l'appel au constructeurError().

Exemples

Appel comme fonction ou comme constructeur

Lorsque le constructeurError() est utilisé comme une fonction, c'est-à-dire sans l'opérateurnew, il renverra un objetError. Aussi, on aura un comportement équivalent qu'on appelleError avec ou sans le mot-clénew.

// cette ligne…const x = Error(`J'ai été créé avec un appel de fonction !`);// …aura le même effet que celle-ci.const y = new Error(`J'ai été construite avec le mot-clé "new" !`);

Transmettre une erreur en utilisantcause

Il est parfois utile d'intercepter une erreur avant de la ré-émettre avec un nouveau message. Dans de tels cas, afin de préserver les informations, on peut passer l'erreur d'origine dans le constructeur avec la propriétécause de l'option.

try {  bibliothequeAvecErreurs();} catch (err) {  throw new Error(`Nouveau message d'erreur`, { cause: err });}

Pour un exemple plus détaillé, voircomment distinguer des erreurs semblables.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Une prothèse d'émulation pourError, avec la prise en charge des fonctionnalités récentes commecause, avec la bibliothèquecore-js
• throw
• try…catch
• Billet d'explication sur les causes d'erreur sur le blog v8 (en anglais)