JavaScript 全局事件机制

Question

我想捕获抛出的每个未定义函数错误。 JavaScript 中是否有全局错误处理工具？ 用例是从闪存中捕获未定义的函数调用。

Answer 1

如何捕捉未处理的 Javascript 错误

将window.onerror事件分配给事件处理程序，例如：

<script type="text/javascript">
window.onerror = function(msg, url, line, col, error) {
   // Note that col & error are new to the HTML 5 spec and may not be 
   // supported in every browser.  It worked for me in Chrome.
   var extra = !col ? '' : '\ncolumn: ' + col;
   extra += !error ? '' : '\nerror: ' + error;

   // You can view the information in an alert to see things working like this:
   alert("Error: " + msg + "\nurl: " + url + "\nline: " + line + extra);

   // TODO: Report this error via ajax so you can keep track
   //       of what pages have JS issues

   var suppressErrorAlert = true;
   // If you return true, then error alerts (like in older versions of 
   // Internet Explorer) will be suppressed.
   return suppressErrorAlert;
};
</script>

如代码中所述，如果window.onerror的返回值为true则浏览器应禁止显示警告对话框。

window.onerror 事件何时触发？

简而言之，当 1.) 存在未捕获的异常或 2.) 发生编译时错误时，将引发该事件。

未捕获的异常

• 抛出“一些消息”
• call_something_undefined();
• cross_origin_iframe.contentWindow.document;，一个安全异常

编译错误

• <script>{</script>
• <script>for(;)</script>
• <script>"oops</script>
• setTimeout("{", 10); ，它将尝试将第一个参数编译为脚本

支持 window.onerror 的浏览器

• 铬 13+
• 火狐 6.0+
• Internet Explorer 5.5+
• 歌剧 11.60+
• Safari 5.1+

截屏：

将其添加到测试页面后，上面的 onerror 代码示例：

<script type="text/javascript">
call_something_undefined();
</script>

AJAX 错误报告示例

var error_data = {
    url: document.location.href,
};

if(error != null) {
    error_data['name'] = error.name; // e.g. ReferenceError
    error_data['message'] = error.line;
    error_data['stack'] = error.stack;
} else {
    error_data['msg'] = msg;
    error_data['filename'] = filename;
    error_data['line'] = line;
    error_data['col'] = col;
}

var xhr = new XMLHttpRequest();

xhr.open('POST', '/ajax/log_javascript_error');
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
    if (xhr.status === 200) {
        console.log('JS error logged');
    } else if (xhr.status !== 200) {
        console.error('Failed to log JS error.');
        console.error(xhr);
        console.error(xhr.status);
        console.error(xhr.responseText);
    }
};
xhr.send(JSON.stringify(error_data));

JSFiddle：

https://jsfiddle.net/nzfvm44d/

参考：

• Mozilla 开发者网络 :: window.onerror
• MSDN :: 处理和避免网页错误第 2 部分：运行时错误
• 回归基础 – JavaScript onerror 事件
• DEV.OPERA :: 使用 window.onerror 更好地处理错误
• 窗口 onError 事件
• 使用 onerror 事件抑制 JavaScript 错误
• SO :: window.onerror 未在 Firefox 中触发

Answer 2

这对您有帮助吗：

<script type="text/javascript">
window.onerror = function() {
    alert("Error caught");
};

xxx();
</script>

我不确定它是如何处理 Flash 错误的...

更新：它在 Opera 中不起作用，但我现在正在攻击 Dragonfly 以查看它得到了什么。 关于黑客蜻蜓的建议来自这个问题：

模拟窗口。 在 Opera 中使用 javascript 的 onerror

Answer 3

复杂的错误处理

如果您的错误处理非常复杂，因此本身可能会引发错误，那么添加一个标志来指示您是否已经处于“errorHandling-Mode”中是很有用的。 像这样：

var appIsHandlingError = false;

window.onerror = function() {
    if (!appIsHandlingError) {
        appIsHandlingError = true;
        handleError();
    }
};

function handleError() {
    // graceful error handling
    // if successful: appIsHandlingError = false;
}

否则，您可能会发现自己陷入无限循环。

Answer 4

试试Atatus ，它为现代 Web 应用程序提供高级错误跟踪和真实用户监控。

https://www.atatus.com/

让我解释一下如何在所有浏览器中获得合理完整的堆栈跟踪。

JavaScript 中的错误处理

现代 Chrome 和 Opera 完全支持 ErrorEvent 和window.onerror的 HTML 5 草案规范。 在这两种浏览器中，您都可以使用window.onerror ，或者正确绑定到 'error' 事件：

// Only Chrome & Opera pass the error object.
window.onerror = function (message, file, line, col, error) {
    console.log(message, "from", error.stack);
    // You can send data to your server
    // sendError(data);
};
// Only Chrome & Opera have an error attribute on the event.
window.addEventListener("error", function (e) {
    console.log(e.error.message, "from", e.error.stack);
    // You can send data to your server
    // sendError(data);
})

不幸的是，Firefox、Safari 和 IE 仍然存在，我们也必须支持它们。 由于堆栈跟踪在window.onerror不可用，我们必须做更多的工作。

事实证明，要从错误中获取e.stack ，我们唯一能做的就是将所有代码包装在try{ }catch(e){ }块中，然后查看e.stack 。 我们可以使用一个名为 wrap 的函数来简化这个过程，该函数接受一个函数并返回一个具有良好错误处理的新函数。

function wrap(func) {
    // Ensure we only wrap the function once.
    if (!func._wrapped) {
        func._wrapped = function () {
            try{
                func.apply(this, arguments);
            } catch(e) {
                console.log(e.message, "from", e.stack);
                // You can send data to your server
                // sendError(data);
                throw e;
            }
        }
    }
    return func._wrapped;
};

这有效。 您手动包装的任何函数都会有很好的错误处理，但事实证明，在大多数情况下，我们实际上可以自动为您完成。

通过更改addEventListener的全局定义，使其自动包装回调，我们可以在大多数代码周围自动插入try{ }catch(e){ } 。 这让现有代码继续工作，但增加了高质量的异常跟踪。

var addEventListener = window.EventTarget.prototype.addEventListener;
window.EventTarget.prototype.addEventListener = function (event, callback, bubble) {
    addEventListener.call(this, event, wrap(callback), bubble);
}

我们还需要确保removeEventListener继续工作。 目前不会，因为addEventListener的参数已更改。 同样，我们只需要在prototype对象上修复这个：

var removeEventListener = window.EventTarget.prototype.removeEventListener;
window.EventTarget.prototype.removeEventListener = function (event, callback, bubble) {
    removeEventListener.call(this, event, callback._wrapped || callback, bubble);
}

将错误数据传输到您的后端

您可以使用图像标签发送错误数据如下

function sendError(data) {
    var img = newImage(),
        src = 'http://yourserver.com/jserror&data=' + encodeURIComponent(JSON.stringify(data));

    img.crossOrigin = 'anonymous';
    img.onload = function success() {
        console.log('success', data);
    };
    img.onerror = img.onabort = function failure() {
        console.error('failure', data);
    };
    img.src = src;
}

免责声明：我是https://www.atatus.com/的 Web 开发人员。

Answer 5

window.onerror似乎没有提供对所有可能错误的访问。 具体来说，它忽略了：

1. <img>加载错误（响应 >= 400）。
2. <script>加载错误（响应 >= 400）。
3. 如果您的应用程序中有许多其他库也以未知方式（jquery、angular 等）操作window.onerror ，则会出现全局错误。
4. 在探索这个之后，我可能还没有遇到很多情况（iframe、堆栈溢出等）。

这是捕获其中许多错误的脚本的开始，以便您可以在开发过程中为您的应用程序添加更强大的调试。

(function(){

/**
 * Capture error data for debugging in web console.
 */

var captures = [];

/**
 * Wait until `window.onload`, so any external scripts
 * you might load have a chance to set their own error handlers,
 * which we don't want to override.
 */

window.addEventListener('load', onload);

/**
 * Custom global function to standardize 
 * window.onerror so it works like you'd think.
 *
 * @see http://www.quirksmode.org/dom/events/error.html
 */

window.onanyerror = window.onanyerror || onanyerrorx;

/**
 * Hook up all error handlers after window loads.
 */

function onload() {
  handleGlobal();
  handleXMLHttp();
  handleImage();
  handleScript();
  handleEvents();
}

/**
 * Handle global window events.
 */

function handleGlobal() {
  var onerrorx = window.onerror;
  window.addEventListener('error', onerror);

  function onerror(msg, url, line, col, error) {
    window.onanyerror.apply(this, arguments);
    if (onerrorx) return onerrorx.apply(null, arguments);
  }
}

/**
 * Handle ajax request errors.
 */

function handleXMLHttp() {
  var sendx = XMLHttpRequest.prototype.send;
  window.XMLHttpRequest.prototype.send = function(){
    handleAsync(this);
    return sendx.apply(this, arguments);
  };
}

/**
 * Handle image errors.
 */

function handleImage() {
  var ImageOriginal = window.Image;
  window.Image = ImageOverride;

  /**
   * New `Image` constructor. Might cause some problems,
   * but not sure yet. This is at least a start, and works on chrome.
   */

  function ImageOverride() {
    var img = new ImageOriginal;
    onnext(function(){ handleAsync(img); });
    return img;
  }
}

/**
 * Handle script errors.
 */

function handleScript() {
  var HTMLScriptElementOriginal = window.HTMLScriptElement;
  window.HTMLScriptElement = HTMLScriptElementOverride;

  /**
   * New `HTMLScriptElement` constructor.
   *
   * Allows us to globally override onload.
   * Not ideal to override stuff, but it helps with debugging.
   */

  function HTMLScriptElementOverride() {
    var script = new HTMLScriptElement;
    onnext(function(){ handleAsync(script); });
    return script;
  }
}

/**
 * Handle errors in events.
 *
 * @see http://stackoverflow.com/questions/951791/javascript-global-error-handling/31750604#31750604
 */

function handleEvents() {
  var addEventListenerx = window.EventTarget.prototype.addEventListener;
  window.EventTarget.prototype.addEventListener = addEventListener;
  var removeEventListenerx = window.EventTarget.prototype.removeEventListener;
  window.EventTarget.prototype.removeEventListener = removeEventListener;

  function addEventListener(event, handler, bubble) {
    var handlerx = wrap(handler);
    return addEventListenerx.call(this, event, handlerx, bubble);
  }

  function removeEventListener(event, handler, bubble) {
    handler = handler._witherror || handler;
    removeEventListenerx.call(this, event, handler, bubble);
  }

  function wrap(fn) {
    fn._witherror = witherror;

    function witherror() {
      try {
        fn.apply(this, arguments);
      } catch(e) {
        window.onanyerror.apply(this, e);
        throw e;
      }
    }
    return fn;
  }
}

/**
 * Handle image/ajax request errors generically.
 */

function handleAsync(obj) {
  var onerrorx = obj.onerror;
  obj.onerror = onerror;
  var onabortx = obj.onabort;
  obj.onabort = onabort;
  var onloadx = obj.onload;
  obj.onload = onload;

  /**
   * Handle `onerror`.
   */

  function onerror(error) {
    window.onanyerror.call(this, error);
    if (onerrorx) return onerrorx.apply(this, arguments);
  };

  /**
   * Handle `onabort`.
   */

  function onabort(error) {
    window.onanyerror.call(this, error);
    if (onabortx) return onabortx.apply(this, arguments);
  };

  /**
   * Handle `onload`.
   *
   * For images, you can get a 403 response error,
   * but this isn't triggered as a global on error.
   * This sort of standardizes it.
   *
   * "there is no way to get the HTTP status from a 
   * request made by an img tag in JavaScript."
   * @see http://stackoverflow.com/questions/8108636/how-to-get-http-status-code-of-img-tags/8108646#8108646
   */

  function onload(request) {
    if (request.status && request.status >= 400) {
      window.onanyerror.call(this, request);
    }
    if (onloadx) return onloadx.apply(this, arguments);
  }
}

/**
 * Generic error handler.
 *
 * This shows the basic implementation, 
 * which you could override in your app.
 */

function onanyerrorx(entity) {
  var display = entity;

  // ajax request
  if (entity instanceof XMLHttpRequest) {
    // 400: http://example.com/image.png
    display = entity.status + ' ' + entity.responseURL;
  } else if (entity instanceof Event) {
    // global window events, or image events
    var target = entity.currentTarget;
    display = target;
  } else {
    // not sure if there are others
  }

  capture(entity);
  console.log('[onanyerror]', display, entity);
}

/**
 * Capture stuff for debugging purposes.
 *
 * Keep them in memory so you can reference them
 * in the chrome debugger as `onanyerror0` up to `onanyerror99`.
 */

function capture(entity) {
  captures.push(entity);
  if (captures.length > 100) captures.unshift();

  // keep the last ones around
  var i = captures.length;
  while (--i) {
    var x = captures[i];
    window['onanyerror' + i] = x;
  }
}

/**
 * Wait til next code execution cycle as fast as possible.
 */

function onnext(fn) {
  setTimeout(fn, 0);
}

})();

它可以像这样使用：

window.onanyerror = function(entity){
  console.log('some error', entity);
};

完整脚本有一个默认实现，它尝试打印出它收到的实体/错误的半可读“显示”版本。 可用于为特定于应用程序的错误处理程序提供灵感。 默认实现还保留对最后 100 个错误实体的引用，因此您可以在它们发生后在 Web 控制台中检查它们，如下所示：

window.onanyerror0
window.onanyerror1
...
window.onanyerror99

注意：这是通过覆盖多个浏览器/本机构造函数上的方法来实现的。 这可能会产生意想不到的副作用。 但是，在开发期间使用它很有用，可以找出发生错误的位置，在开发期间将日志发送到 NewRelic 或 Sentry 等服务，以便我们可以在开发期间测量错误，并在登台时调试正在发生的事情更深的层次。 然后可以在生产中关闭它。

希望这可以帮助。

Answer 6

// display error messages for a page, but never more than 3 errors
window.onerror = function(msg, url, line) {
if (onerror.num++ < onerror.max) {
alert("ERROR: " + msg + "\n" + url + ":" + line);
return true;
}
}
onerror.max = 3;
onerror.num = 0;

Answer 7

还应该保留先前关联的 onerror 回调

<script type="text/javascript">

(function() {
    var errorCallback = window.onerror;
    window.onerror = function () {
        // handle error condition
        errorCallback && errorCallback.apply(this, arguments);
    };
})();

</script>

Answer 8

如果您想要统一的方式来处理未捕获的错误和未处理的承诺拒绝，您可以查看uncaught library 。

编辑

<script type="text/javascript" src=".../uncaught/lib/index.js"></script>

<script type="text/javascript">
    uncaught.start();
    uncaught.addListener(function (error) {
        console.log('Uncaught error or rejection: ', error.message);
    });
</script>

它监听窗口。 unhandledrejection除了 window.onerror。

Answer 9

我建议尝试一下Trackjs 。

将错误记录为服务。

设置非常简单。 只需向每个页面添加一个 <script> 行，就可以了。 这也意味着如果您决定不喜欢它，删除它会非常简单。

还有其他服务，如Sentry （如果您可以托管自己的服务器，则它是开源的），但它没有 Trackjs 所做的。 Trackjs 记录用户在他们的浏览器和您的网络服务器之间的交互，以便您可以实际跟踪导致错误的用户步骤，而不仅仅是文件和行号引用（可能还有堆栈跟踪）。

Answer 10

您可以通过为 window.onerror 分配一个函数来监听 onerror 事件：

 window.onerror = function (msg, url, lineNo, columnNo, error) {
        var string = msg.toLowerCase();
        var substring = "script error";
        if (string.indexOf(substring) > -1){
            alert('Script Error: See Browser Console for Detail');
        } else {
            alert(msg, url, lineNo, columnNo, error);
        }   
      return false; 
  };