Constructeur Error()

Syntaxe

new Error()
new Error(message)
new Error(message, options)
new Error(message, fileName)
new Error(message, fileName, lineNumber)

Error()
Error(message)
Error(message, options)
Error(message, fileName)
Error(message, fileName, lineNumber)

Paramtres

message Facultatif

Une description de l'erreur, comprhensible par un humain.

options Facultatif

Un objet avec les proprits suivantes :

cause Facultatif

Une valeur indiquant la cause spcifique de l'erreur, reflte dans la proprit cause. Lors de l'interception et de la relance d'une erreur avec un message d'erreur plus prcis ou utile, cette proprit peut tre utilise pour transmettre l'erreur originale.

fileName Facultatif

Le chemin vers le fichier ayant dclench cette erreur, reflt dans la proprit fileName. Par dfaut, il s'agit du nom du fichier contenant le code qui a appel le constructeur Error().

lineNumber Facultatif

Le numro de ligne dans le fichier o l'erreur a t leve, reflt dans la proprit lineNumber. Par dfaut, il s'agit du numro de ligne contenant l'appel au constructeur Error().

Exemples

Appeler une fonction ou un nouveau constructeur

Lorsque Error est utilis comme une fonction, c'est--dire sans new, il retourne un objet Error. Ainsi, un simple appel Error produit le mme rsultat que la construction d'un objet Error avec le mot-cl new.

const x = Error("J'ai t cr avec un appel de fonction !");

// la ligne au-dessus a le mme effet que la suivante
const y = new Error(`J'ai t construite avec le mot-cl "new" !`);

Transmettre une erreur en utilisant cause

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

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

Pour un exemple plus dtaill, voir comment distinguer des erreurs semblables.

Omettre l'argument options

JavaScript ne tente de lire options.cause que si options est un objet cela vite toute ambigut avec l'autre signature non standard Error(message, fileName, lineNumber), qui exige que le deuxime paramtre soit une chane de caractres. Si vous omettez options, passez une valeur primitive comme options, ou passez un objet sans la proprit cause, alors l'objet Error cr n'aura pas de proprit cause.

// Omettre l'argument options
const erreur1 = new Error("Message d'erreur");
console.log("cause" in erreur1); // false

// Passage d'une valeur primitive
const erreur2 = new Error("Message d'erreur", "");
console.log("cause" in erreur2); // false

// Passage d'un objet sans proprit cause
const erreur3 = new Error("Message d'erreur", { details: "erreur HTTP" });
console.log("cause" in erreur3); // false

Spcifications

Compatibilit des navigateurs

Voir aussi

• Prothse d'mulation pour Error, avec cause pris en charge dans core-js (angl.)
• Prothse d'mulation es-shims pour la proprit cause de Error (angl.)
• L'instruction throw
• L'instruction try...catch
• Causes d'erreur (angl.) sur v8.dev (2021)