CKTIS / JavaScript
window.onerror — gestione globale degli errori degli script
window.onerror gestisce gli eventi error segnalati alla finestra. Per un ErrorEvent, la funzione riceve cinque argomenti. Restituire true annulla la segnalazione predefinita dell’errore, ma non riprende il codice interrotto.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
window.onerror = (message, source, lineno, colno, error) => { /* return true to cancel default reporting */ };
window.onerror = null;window.onerror è la proprietà gestore dell’evento error dell’oggetto Window, usata per osservare gli errori degli script non intercettati. Fa parte dello standard HTML, non di una specifica edizione ECMAScript. I motori dei browser attuali la supportano; la presenza di Node 24 in un repository non dimostra il supporto di questa API del browser.
Per un ErrorEvent, la funzione riceve message (messaggio di errore), source (URL dello script), lineno (riga), colno (colonna) ed error (il valore segnalato, che non è necessariamente un oggetto Error). Alcuni dettagli potrebbero non essere disponibili: per gli errori silenziati degli script cross-origin, il messaggio è Script error., l’URL è vuoto, le coordinate sono 0 ed error è null.
Restituire esattamente true annulla la segnalazione predefinita; false e undefined non lo fanno. Questo non corregge l’errore né riprende l’esecuzione interrotta. window.addEventListener("error", handler) riceve un solo oggetto evento; per annullarlo si usa event.preventDefault(), non il valore restituito.
L’assegnazione sostituisce il gestore precedente e null lo rimuove. I rifiuti di Promise non gestiti si trattano con unhandledrejection, non con window.onerror. L’esempio invia un ErrorEvent sintetico con dati fissi e ripristina il gestore precedente; non genera una vera eccezione non intercettata.
Esempi
(() => {
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;
}
})();Risultato
Demo|demo.js|7|3|true canceled=true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.