Baseline Widely available
Le constructeur Error
permet de créer un objet représentant une erreur.
new Error();
new Error(message);
new Error(message, options);
new Error(message, nomFichier);
new Error(message, nomFichier, numeroLigne);
Paramètres
message
Facultatif
Une description de l'erreur, compréhensible par un humain.
options
Facultatif
Un objet avec les propriétés suivantes :
cause
Facultatif
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.
nomFichier
Facultatif Non standard
La valeur de la propriété nomFichier
pour l'objet Error
créé. Par défaut, il s'agit du nom du fichier contenant le code qui a invoqué le constructeur Error()
.
numeroLigne
Facultatif Non standard
La valeur de la propriété numeroLigne
pour l'objet Error
créé. Par défaut, il s'agit du numéro de ligne du fichier contenant l'appel au constructeur Error()
.
Lorsque le constructeur Error()
est utilisé comme une fonction, c'est-à -dire sans l'opérateur new
, il renverra un objet Error
. Aussi, on aura un comportement équivalent qu'on appelle Error
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 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 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é, voir comment distinguer des erreurs semblables.
Spécifications Compatibilité des navigateurs Voir aussiRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4