当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript错误监控设计全解析

JavaScript错误监控设计全解析

2025-10-21 22:32:01 0浏览收藏

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《前端JavaScript错误监控设计指南》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

答案：通过window.onerror和addEventListener捕获JavaScript错误，结合上下文信息与用户行为，利用sendBeacon上报并节流，配合Source Map还原堆栈，实现稳定高效的前端监控。

如何设计一个前端监控系统以捕获JavaScript错误？

设计一个前端监控系统来捕获 JavaScript 错误，核心在于全面收集运行时异常、结构化上报数据，并确保不影响用户正常使用。关键点是利用浏览器提供的全局错误捕获机制，结合自定义日志和性能数据，实现稳定、低损耗的监控能力。

1. 捕获全局JavaScript错误

通过监听全局事件，可以捕获未被处理的脚本错误和资源加载问题。

window.onerror：捕获同步 JavaScript 运行时错误，包括跨域脚本错误（需配合 CORS 和 script 标签 crossorigin 属性）
window.addEventListener('error')：可捕获更广泛的资源加载错误，如 img、script 加载失败
window.addEventListener('unhandledrejection')：专门用于捕获未处理的 Promise 异常，避免异步错误静默失败

示例代码：

window.onerror = function(message, source, lineno, colno, error) {
  reportError({
    type: 'runtime',
    message: error?.message || message,
    stack: error?.stack,
    file: source,
    line: lineno,
    column: colno,
    url: location.href,
    userAgent: navigator.userAgent
  });
  return true; // 阻止默认上报
};

window.addEventListener('unhandledrejection', event => {
  reportError({
    type: 'promise',
    message: event.reason?.message || 'Unknown promise rejection',
    stack: event.reason?.stack,
    url: location.href
  });
});

2. 收集上下文信息以辅助定位

单纯记录错误信息不足以排查问题，需附加用户环境和行为上下文。

用户设备信息：浏览器类型、版本、操作系统、屏幕分辨率
网络状态：有效连接类型（如 4g、wifi）、RTT 延迟
页面状态：当前 URL、referrer、DOMReady 或 load 是否完成
自定义标记：用户 ID（匿名化）、路由路径、操作流程标记（如“点击提交按钮后”）

建议将上下文封装为统一对象，在上报时合并：

function getContext() {
  return {
    url: location.href,
    referrer: document.referrer,
    timestamp: Date.now(),
    viewport: `${window.innerWidth}x${window.innerHeight}`,
    connection: navigator?.connection?.effectiveType,
    readyState: document.readyState
  };
}

3. 实现错误上报与节流控制

频繁上报可能影响性能或打满服务端接口，需合理控制上报频率和时机。

使用 navigator.sendBeacon 在页面卸载前发送数据，保证日志不丢失
对重复错误进行去重或限频，例如相同错误5分钟内只上报一次
设置采样率，高流量场景下按比例采集（如10%），避免数据爆炸
离线缓存：在 localStorage 中暂存错误，下次页面打开时补发

基础上报函数示例：

function reportError(data) {
  const payload = JSON.stringify({ ...data, ...getContext() });

  if (navigator.sendBeacon) {
    navigator.sendBeacon('/log', payload);
  } else {
    fetch('/log', {
      method: 'POST',
      body: payload,
      keepalive: true // 确保请求在页面关闭后仍可完成
    });
  }
}