使用 statpx 追踪网站 JavaScript 错误
JavaScript 错误是无声的杀手。结账页面上的损坏脚本、注册表单上的失败 API 调用、导航菜单中未处理的 Promise 拒绝 — 您的用户会遇到这些问题然后离开，而您永远不知道原因。
传统的监控工具如 Sentry 功能强大，但需要大量的设置、持续维护和通常会产生成本。statpx 采用了不同的方法：JavaScript 错误追踪是内置的、自动的，并且需要零配置。
statpx 如何捕获 JavaScript 错误
一旦您安装了 statpx 追踪代码片段，它就会开始监听两个浏览器事件：
- window.onerror — 捕获标准 JavaScript 错误：未捕获异常、语法错误、类型错误等
- window.onunhandledrejection — 捕获未处理的 Promise 拒绝，这在现代异步 JavaScript 代码中越来越常见
当任一事件触发时，statpx 会记录错误信息、源文件、行号以及发生错误的页面 — 全部实时从真实用户的浏览器中记录。无采样、无合成测试、无需安装单独的 SDK。
查看您的 JS 错误仪表盘
在您的 statpx 仪表盘中，导航到任何网站并点击左侧边栏中的 JS 错误。仪表盘显示：
- 总错误数 — 在选定期间内捕获了多少错误事件
- 唯一错误类型 — 不同的错误信息（帮助您确定优先级）
- 受影响页面 — 有多少不同的网址至少出现过一个错误
- 错误率 — 每次页面浏览的错误数，按清洁 / 低 / 高 进行颜色编码
顶部错误表按信息分组错误，显示有多少会话受影响、有多少页面出现了错误、以及最后一次看到它的时间。这让您可以立即发现哪些错误广泛存在，哪些只是个别情况。
错误率：什么是正常的？
少量 JavaScript 错误是不可避免的 — 浏览器扩展注入脚本、广告拦截器修改 DOM、较旧的浏览器表现异常。作为一般基准：
- 低于 0.5% — 健康。主要是扩展相关的噪音。
- 0.5%–2% — 值得调查。可能是影响某些用户的真实问题。
- 超过 2% — 立即采取行动。您的大部分用户正在经历损坏的功能。
statpx 对错误率徽章进行颜色编码（绿色 / 琥珀色 / 红色），以便您一目了然地判断是否需要采取行动。
发现最重要的页面
包含错误的页面表显示哪些网址产生最多错误。按错误数排序以找到性能最差的页面。在 /checkout 或 /signup 上的高错误数远比很少访问的博客文章上的错误危害更大。
一旦您确定了页面，使用仪表盘底部的最近错误日志查看单个事件 — 包括错误信息、源文件和行号。将其与您的 JavaScript 源地图进行交叉引用，以查找导致问题的确切代码。
statpx 捕获的错误类型
标准 JavaScript 错误（window.onerror）
这些是经典的运行时错误：TypeError: Cannot read properties of undefined、ReferenceError: x is not defined、失败的脚本加载和动态评估代码中的语法错误。每一个都在 statpx 中标记为错误类型。
未处理的 Promise 拒绝
现代 JavaScript 非常依赖 async/await 和 Promises。当 Promise 在没有 .catch() 处理程序的情况下被拒绝时，浏览器会触发 unhandledrejection 事件。这些特别狡猾 — 对于最终用户，它们并不总是在浏览器控制台中显示。statpx 会捕获它们并在您的仪表盘中将其标记为Promise类型。
隐私和性能
statpx 仅捕获错误信息、文件和行号 — 永远不捕获本地变量的值、用户输入或任何个人身份信息。错误有效负载很小（少于 500 字节），并异步发送，因此对您网站的性能或核心网页活力指标没有可衡量的影响。
底线
生产中的 JavaScript 错误几乎总是看不见的，直到用户投诉 — 或直到您注意到转化率下降。statpx 会自动使它们可见，无需任何额外设置、SDK 或持续成本。
今天检查您的 JavaScript 错误仪表盘。如果您已经安装了 statpx，数据已经存在。您可能会对一直默默破坏的东西感到惊讶。