reporting api 不捕获崩溃或接口弃用，仅接收浏览器自动生成的三类结构化报告：csp违规、网络错误（nel）和干预报告；js崩溃需用window.onerror等监听，弃用警告需重写console.warn捕获。
Reporting API 本身不直接捕获“崩溃记录”，也不能报告“接口弃用（deprecation）”。它主要用于接收浏览器主动发出的**安全违规、内容策略异常、网络错误等结构化报告**。真正的 JavaScript 崩溃（如未捕获异常、语法错误、Promise rejection）需靠 window.onerror、window.onunhandledrejection 等前端监听机制；而接口弃用警告（如 console.warn("navigator.geolocation is deprecated")）默认只出现在 DevTools Console，不会自动上报。
Reporting API 能监控什么？
它能接收三类标准报告（由浏览器自动生成）：
- CSP 违规报告：当页面尝试加载被 Content-Security-Policy 拦截的资源（如外链脚本、内联样式）时触发；
- 网络错误报告（Network Error Logging, NEL）：记录 fetch/XHR 请求失败（如 DNS 失败、连接超时、TLS 错误），但不包括 4xx/5xx HTTP 状态码；
- 干预报告（Intervention Reports）：当浏览器因安全或性能原因主动禁用某项功能（如自动播放音频、不安全上下文中的 geolocation）时发出。
注意：目前（2026 年）没有浏览器原生支持通过 Reporting API 上报 JS 崩溃或接口弃用日志。Chrome 曾实验性支持 deprecation reports，但已移除；Firefox 和 Safari 从未实现。
如何补足崩溃监控缺口？
要真正捕获前端崩溃，必须组合使用以下机制：
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
-
全局错误监听：注册
window.onerror捕获同步错误，window.onunhandledrejection捕获未处理 Promise 拒绝； - Source Map 关联：上传 sourcemap 到监控平台，将压缩代码错误堆栈还原为可读源码行；
-
主动上报封装：在错误处理器中构造 JSON 报告，通过
fetch发送到你自己的后端（例如/api/errors），而非依赖 Reporting API； - 会话关联：上报时附带用户 ID（从 Cookie 或内存变量读取），便于定位问题影响范围。
如何捕获接口弃用警告？
弃用警告是 console.warn 输出，浏览器不自动上报。可行做法是：
- 重写 console.warn：在页面加载早期劫持该方法，筛选含 “deprecated”、“is deprecated”、“will be removed” 等关键词的日志，触发自定义上报；
- 限制使用范围：仅在开发环境或灰度流量中启用，避免生产环境性能损耗；
-
结合静态扫描：用工具（如 ESLint +
eslint-plugin-compat）在构建阶段检查代码中是否调用了已知废弃的 API（如document.execCommand）。
Reporting API 的正确配置示例
若仍希望利用它增强可观测性，可配置如下响应头（以 CSP + Intervention 为例）：
Content-Security-Policy: default-src 'self'; report-to csp-intervention-group
Report-To: {
"group": "csp-intervention-group",
"max_age": 10886400,
"endpoints": [{"url": "https://api.yoursite.com/reporting"}],
"include_subdomains": true
}
后端接收后，需解析 report.body.type 字段区分是 "csp-violation" 还是 "intervention"，再做归类存储与告警。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
