CKTIS / JavaScript
ErrorEvent — description de l’erreur et valeur associée
ErrorEvent est une interface de l’API Web qui décrit les erreurs dans les scripts ou les fichiers. Sa propriété message fournit une description textuelle, tandis que error contient la valeur JavaScript associée, qui n’est pas nécessairement un objet Error.
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 ErrorEvent(type, { message, error });
event.message;
event.error;ErrorEvent représente un événement contenant des informations sur une erreur dans un script ou un fichier. Il hérite de Event et est également disponible dans les Web Workers. Il s’agit d’une interface de l’API Web définie par le standard HTML, et non d’un objet intégré à ECMAScript. La présence de Node 24 dans un projet ne prouve pas que cette API est prise en charge dans le navigateur.
ErrorEvent.message est une propriété en lecture seule qui renvoie une description de l’erreur, lisible par un humain, sous forme de chaîne. ErrorEvent.error est également en lecture seule, mais renvoie la valeur JavaScript associée. Il peut s’agir d’un Error ou d’une DOMException, mais ne présume pas de ce type : vérifie la valeur et son type avant d’accéder aux propriétés propres aux erreurs.
new ErrorEvent(type, { message, error }) crée un événement avec une description et une valeur d’erreur fournies séparément. event.message n’est pas nécessairement égal à event.error.message. L’exemple fournit volontairement des chaînes différentes, et la comparaison === montre que error fait référence au même objet que cause. Le simple fait de créer l’événement ne déclenche pas d’exception et ne distribue pas l’événement aux écouteurs.
Exemples
(() => {
const cause = new Error("Invalid input");
const event = new ErrorEvent("error", {
message: "Validation failed",
error: cause,
});
console.log(event.message);
console.log(event.error === cause);
console.log(event.error.message);
})();Résultat
Validation failed true Invalid input
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.