Ricerca…


Sintassi

  • window.onerror = function (eventOrMessage, url, lineNumber, colNumber, error) {...}

Parametri

Parametro Dettagli
eventOrMessage Alcuni browser chiameranno il gestore di eventi con un solo argomento, un oggetto Event . Tuttavia, altri browser, in particolare quelli più vecchi e quelli più vecchi, forniranno un messaggio String come primo argomento.
url Se un gestore viene chiamato con più di 1 argomento, il secondo argomento di solito è un URL di un file JavaScript che è la fonte del problema.
lineNumber Se un gestore viene chiamato con più di 1 argomento, il terzo argomento è un numero di riga all'interno del file di origine JavaScript.
colNumber Se un gestore viene chiamato con più di 1 argomento, il quarto argomento è il numero di colonna all'interno del file di origine JavaScript.
errore Se un gestore viene chiamato con più di 1 argomento, il quinto argomento a volte è un oggetto Error che descrive il problema.

Osservazioni

Sfortunatamente, window.onerror è stato storicamente implementato in modo diverso da ciascun fornitore. Le informazioni fornite nella sezione Parametri sono un'approssimazione di cosa aspettarsi attraverso diversi browser e le loro versioni.

Gestione di window.onerror per riportare tutti gli errori sul lato server

L'esempio seguente ascolta l'evento window.onerror e utilizza una tecnica beacon dell'immagine per inviare le informazioni tramite i parametri GET di un URL.

var hasLoggedOnce = false;

// Some browsers (at least Firefox) don't report line and column numbers
// when event is handled through window.addEventListener('error', fn). That's why
// a more reliable approach is to set an event listener via direct assignment.
window.onerror = function (eventOrMessage, url, lineNumber, colNumber, error) {
    if (hasLoggedOnce || !eventOrMessage) {
        // It does not make sense to report an error if:
        // 1. another one has already been reported -- the page has an invalid state and may produce way too many errors.
        // 2. the provided information does not make sense (!eventOrMessage -- the browser didn't supply information for some reason.)
        return;
    }
    hasLoggedOnce = true;
    if (typeof eventOrMessage !== 'string') {
        error = eventOrMessage.error;
        url = eventOrMessage.filename || eventOrMessage.fileName;
        lineNumber = eventOrMessage.lineno || eventOrMessage.lineNumber;
        colNumber = eventOrMessage.colno || eventOrMessage.columnNumber;
        eventOrMessage = eventOrMessage.message || eventOrMessage.name || error.message || error.name;
    }
    if (error && error.stack) {
        eventOrMessage = [eventOrMessage, '; Stack: ', error.stack, '.'].join('');
    }
    var jsFile = (/[^/]+\.js/i.exec(url || '') || [])[0] || 'inlineScriptOrDynamicEvalCode',
        stack = [eventOrMessage, ' Occurred in ', jsFile, ':', lineNumber || '?', ':', colNumber || '?'].join('');

    // shortening the message a bit so that it is more likely to fit into browser's URL length limit (which is 2,083 in some browsers)
    stack = stack.replace(/https?\:\/\/[^/]+/gi, '');
    // calling the server-side handler which should probably register the error in a database or a log file
    new Image().src = '/exampleErrorReporting?stack=' + encodeURIComponent(stack);
    
    // window.DEBUG_ENVIRONMENT a configurable property that may be set to true somewhere else for debugging and testing purposes.
    if (window.DEBUG_ENVIRONMENT) {
        alert('Client-side script failed: ' + stack);
    }
}


Modified text is an extract of the original Stack Overflow Documentation
Autorizzato sotto CC BY-SA 3.0
Non affiliato con Stack Overflow