CKTIS / JavaScript
window.onerror — gestion globale des erreurs de script
window.onerror gère les événements error signalés à la fenêtre. Pour un ErrorEvent, la fonction reçoit cinq arguments. Renvoyer true annule le signalement d’erreur par défaut, sans reprendre le code interrompu.
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
window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;window.onerror est la propriété de gestionnaire d’événement error de l’objet Window, utilisée pour observer les erreurs de script non interceptées. Elle relève du standard HTML, et non d’une édition particulière d’ECMAScript. Les moteurs de navigateur actuels la prennent en charge ; la présence de Node 24 dans un dépôt ne prouve pas que cette API de navigateur est prise en charge.
Pour un ErrorEvent, la fonction reçoit message (le message d’erreur), source (l’URL du script), lineno (la ligne), colno (la colonne) et error (la valeur signalée, qui n’est pas nécessairement un objet Error). Certains détails peuvent être indisponibles : pour les erreurs de script inter-origines silencieuses, le message est Script error., l’URL est vide, les coordonnées valent 0 et error vaut null.
Renvoyer exactement true annule le signalement par défaut ; false et undefined ne le font pas. Cela ne corrige pas l’erreur et ne reprend pas l’exécution interrompue. window.addEventListener("error", handler) reçoit un seul objet événement ; l’annulation se fait avec event.preventDefault(), et non avec la valeur de retour.
Une affectation remplace le gestionnaire précédent, et null le supprime. Les rejets de promesse non gérés relèvent de unhandledrejection, pas de window.onerror. L’exemple déclenche un ErrorEvent synthétique avec des données fixes et restaure le gestionnaire précédent ; il ne produit pas de véritable exception non interceptée.
Exemples
(() => {
const previous = window.onerror;
const failure = new Error("Demo");
window.onerror = (message, source, lineno, colno, error) => {
console.log(`${message}|${source}|${lineno}|${colno}|${error === failure}`);
return true;
};
try {
const event = new ErrorEvent("error", {
message: "Demo",
filename: "demo.js",
lineno: 7,
colno: 3,
error: failure,
cancelable: true
});
window.dispatchEvent(event);
console.log(`canceled=${event.defaultPrevented}`);
} finally {
window.onerror = previous;
}
})();Résultat
Demo|demo.js|7|3|true canceled=true
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.