SuperAPI AI 工具集

client-error-observability-contracts

部署与运维

查看项目

更新于 10-16 09:47

技能介绍

用途:在前端错误采集或监控行为异常时(如生产环境只报“Script error.”、事件处理器或异步失败绕过框架边界),检查并修复捕获链路契约,目标是不让任何一类错误静默消失,也不让敏感数据静默外发。

主要能力与要点:同步抛出触发 window.onerror/error,无 .catch 的 rejected promise 触发 unhandledrejection,两者互不重叠,只接一个会漏掉一整类失败;资源加载错误(img/script 404)不冒泡到 window.onerror,需用 addEventListener('error', fn, true) 捕获。React 错误边界只捕获渲染、生命周期和构造函数错误,事件处理器、setTimeout、异步回调与 SSR 错误需靠全局处理器或本地 try/catch。跨域脚本需同时设置 crossorigin="anonymous" 与资源服务器的 Access-Control-Allow-Origin 才能获得可读堆栈。压缩包需在构建时上传 source map(现代 SDK 通过 Debug ID 匹配),并采用隐藏 source map、上传后从部署产物删除 .map,避免公开源码。分组应显式设置 fingerprint,把动态值放入 context,避免一个 bug 碎片化成上千 issue。PII 需在 SDK 的 beforeSend/scrubber 客户端侧脱敏,保持 sendDefaultPii 关闭,PAN/CVV 绝不进入 payload。

必要用法:可用 rg 检索 .onerror、addEventListener('error'、addEventListener('unhandledrejection、sourceMappingURL、Sentry.init|captureException|beforeSend|fingerprint|sendDefaultPii|onRecoverableError|onUncaughtError 等;find dist build out -name '*.map' 检查误发布的 source map。

适用场景:前端错误监控接入与代码审查。限制:资料未提供具体安装命令、价格与平台支持信息。