CKTIS / JavaScript
ErrorEvent.error et ErrorEvent.message : valeur d’erreur et message
`message` contient le texte de diagnostic de l’événement, tandis que `error` contient la valeur JavaScript associée, qui n’est pas forcément un objet `Error`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new ErrorEvent(type)
new ErrorEvent(type, { message, error })
event.message
event.errorErrorEvent est une interface de la plateforme web, et non un type natif d’ECMAScript 2024. Sur une instance, event.message renvoie une chaîne décrivant le problème et event.error la valeur JavaScript associée. Ces deux propriétés sont en lecture seule. error peut contenir un objet Error, une valeur primitive comme 0, null ou undefined. Ne supposez pas que cette valeur possède son propre message ou une trace de la pile d’appels.
new ErrorEvent(type, options) initialise ces deux propriétés indépendamment. Selon la norme HTML, si message est omis, sa valeur par défaut est "" ; si error est omis, sa valeur par défaut est undefined. Si la valeur fournie est un objet Error, event.error.message appartient à cet objet et ne correspond pas forcément à event.message.
Quand le navigateur signale sur la fenêtre une exception de script non interceptée, un écouteur enregistré avec window.addEventListener("error", handler) reçoit un seul ErrorEvent. Pour le même événement, window.onerror reçoit cinq arguments positionnels : (message, source, lineno, colno, error). Tout événement error n’est pas un ErrorEvent : un échec de chargement de ressource sur un élément ne garantit pas ces propriétés. Le navigateur peut signaler un rejet de promesse non géré au moyen d’un événement distinct, unhandledrejection, doté d’une propriété reason. Il ne déclenche pas cet événement si les erreurs du script sont masquées ou si le rejet est traité avant la notification.
Si les détails de l’erreur d’un script classique sont masqués, par exemple pour un script d’une autre origine chargé sans CORS, le rapport contient "Script error." dans message et null dans error. Le message sert au diagnostic, pas de code d’erreur stable. Hors du navigateur, vérifiez si l’environnement d’exécution fournit ErrorEvent.
Exemples
{
// Use the native constructor when available; otherwise model only these two properties.
const ErrorEvent = globalThis.ErrorEvent ?? class extends Event {
#message;
#error;
constructor(type, { message = "", error } = {}) {
super(type);
this.#message = String(message);
this.#error = error;
}
get message() { return this.#message; }
get error() { return this.#error; }
};
const original = new Error("Invalid input");
const event = new ErrorEvent("error", {
message: "Validation failed",
error: original,
});
console.log(event.message);
console.log(event.error === original);
console.log(event.error.message);
}Résultat
Validation failed true Invalid input
Exécutez le code dans Node.js 24 ou dans la console d’un navigateur. Si `ErrorEvent` n’est pas disponible nativement, l’exemple utilise un substitut local qui reproduit uniquement les deux propriétés présentées. Le code crée un événement synthétique sans lever d’exception ni distribuer l’événement. La ligne `true` confirme qu’il s’agit du même objet ; la première et la dernière ligne affichent des messages différents.
Leçons associées
- JavaScript · Leçon 23 · Avancé · Version : 4