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

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

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

2025-10-09

浏览次数：次

返回列表

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

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

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

1. 捕获全局J*aScript错误

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

window.onerror：捕获同步 J*aScript 运行时错误，包括跨域脚本错误（需配合 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: n*igator.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: n*igator?.connection?.effectiveType,
    readyState: document.readyState
  };
}

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

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

察言观数AskTable

企业级AI数据表格智能体平台

78 查看详情察言观数AskTable

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

基础上报函数示例：

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

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