sentry-miniapp 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +15 -3
  2. package/dist/sentry-miniapp.cjs.js +7 -7193
  3. package/dist/sentry-miniapp.cjs.js.map +1 -1
  4. package/dist/sentry-miniapp.esm.js +3781 -5221
  5. package/dist/sentry-miniapp.esm.js.map +1 -1
  6. package/dist/sentry-miniapp.umd.js +7 -7197
  7. package/dist/sentry-miniapp.umd.js.map +1 -1
  8. package/dist/types/client.d.ts +4 -0
  9. package/dist/types/client.d.ts.map +1 -1
  10. package/dist/types/crossPlatform.d.ts +7 -0
  11. package/dist/types/crossPlatform.d.ts.map +1 -1
  12. package/dist/types/helpers.d.ts +9 -9
  13. package/dist/types/index.d.ts +1 -0
  14. package/dist/types/index.d.ts.map +1 -1
  15. package/dist/types/integrations/console.d.ts +5 -0
  16. package/dist/types/integrations/console.d.ts.map +1 -1
  17. package/dist/types/integrations/dedupe.d.ts +6 -0
  18. package/dist/types/integrations/dedupe.d.ts.map +1 -1
  19. package/dist/types/integrations/globalhandlers.d.ts +8 -4
  20. package/dist/types/integrations/globalhandlers.d.ts.map +1 -1
  21. package/dist/types/integrations/index.d.ts +2 -0
  22. package/dist/types/integrations/index.d.ts.map +1 -1
  23. package/dist/types/integrations/networkbreadcrumbs.d.ts +35 -0
  24. package/dist/types/integrations/networkbreadcrumbs.d.ts.map +1 -1
  25. package/dist/types/integrations/networkstatus.d.ts +13 -0
  26. package/dist/types/integrations/networkstatus.d.ts.map +1 -0
  27. package/dist/types/integrations/pagebreadcrumbs.d.ts +8 -0
  28. package/dist/types/integrations/pagebreadcrumbs.d.ts.map +1 -1
  29. package/dist/types/integrations/performance.d.ts.map +1 -1
  30. package/dist/types/integrations/router.d.ts +5 -0
  31. package/dist/types/integrations/router.d.ts.map +1 -1
  32. package/dist/types/integrations/session.d.ts +25 -0
  33. package/dist/types/integrations/session.d.ts.map +1 -0
  34. package/dist/types/integrations/system.d.ts +8 -0
  35. package/dist/types/integrations/system.d.ts.map +1 -1
  36. package/dist/types/integrations/trycatch.d.ts +1 -12
  37. package/dist/types/integrations/trycatch.d.ts.map +1 -1
  38. package/dist/types/polyfills.d.ts.map +1 -1
  39. package/dist/types/sdk.d.ts.map +1 -1
  40. package/dist/types/stacktrace.d.ts +10 -0
  41. package/dist/types/stacktrace.d.ts.map +1 -0
  42. package/dist/types/transports/offlineStore.d.ts +4 -1
  43. package/dist/types/transports/offlineStore.d.ts.map +1 -1
  44. package/dist/types/transports/xhr.d.ts.map +1 -1
  45. package/dist/types/types.d.ts +14 -4
  46. package/dist/types/types.d.ts.map +1 -1
  47. package/dist/types/version.d.ts +1 -1
  48. package/package.json +1 -1
package/README.md CHANGED
@@ -27,6 +27,10 @@
27
27
  - **⚡ 深度性能监控**:集成小程序 Performance API,全面采集导航性能(FCP/LCP)、渲染性能、资源加载耗时及用户自定义性能标记。
28
28
  - **�️ 智能降噪与过滤**:内置强大的错误去重和采样率控制机制,避免日志风暴。
29
29
  - **🔧 跨端框架友好**:完美支持在 Taro、uni-app 等第三方多端编译框架中集成使用。
30
+ - **🔗 分布式追踪**:自动在网络请求中注入 `sentry-trace` / `baggage` 头,串联小程序与后端服务的完整调用链。
31
+ - **📊 Session 健康监控**:自动管理会话生命周期,在 Sentry Release Health 面板展示崩溃率和会话健康数据。
32
+ - **📶 网络状态监控**:实时追踪网络变化(WiFi/4G/离线),帮助排查网络相关的异常。
33
+ - **🔍 堆栈解析**:内置多平台堆栈解析器,支持 V8/Safari/JavaScriptCore 格式,配合 SourceMap 精准定位错误。
30
34
 
31
35
  ---
32
36
 
@@ -79,7 +83,15 @@ Sentry.init({
79
83
 
80
84
  // --- 性能与采样率 ---
81
85
  sampleRate: 1.0, // 异常上报采样率 (0.0 - 1.0)
82
-
86
+
87
+ // --- 分布式追踪 ---
88
+ enableTracePropagation: true, // [新增] 自动在请求头中注入 sentry-trace/baggage(默认 true)
89
+ tracePropagationTargets: ['api.example.com'], // [新增] 仅对指定域名注入追踪头(为空则全部注入)
90
+
91
+ // --- Session 与网络监控 ---
92
+ enableAutoSessionTracking: true, // [新增] 自动管理 Session 生命周期(默认 true)
93
+ enableNetworkStatusMonitoring: true, // [新增] 实时监控网络状态变化(默认 true)
94
+
83
95
  // 可选:性能监控配置
84
96
  integrations: [
85
97
  Sentry.performanceIntegration({
@@ -200,7 +212,7 @@ Sentry.captureFeedback({
200
212
 
201
213
  ## 📦 主包体积优化 (0KB 主包占用方案)
202
214
 
203
- 小程序的“主包体积”非常宝贵(通常限制在 2MB 以内)。`sentry-miniapp` 由于集成了完整的 `@sentry/core` 核心引擎和多端适配,原始体积约在 200KB 左右。
215
+ 小程序的“主包体积”非常宝贵(通常限制在 2MB 以内)。`sentry-miniapp` 由于集成了完整的 `@sentry/core` 核心引擎和多端适配,原始体积约在 100KB 左右。
204
216
 
205
217
  如果您非常在意主包体积,**强烈建议使用平台提供的「分包异步化」或「动态加载」特性**,将 SDK 的体积完全转移到分包中。
206
218
 
@@ -231,7 +243,7 @@ App({
231
243
  });
232
244
  ```
233
245
 
234
- *通过这种方式,Sentry 的 200KB 体积将**全部算入 `subpackageA` 的分包体积**,主包占用为 0!*
246
+ *通过这种方式,Sentry 的 100KB 体积将**全部算入 `subpackageA` 的分包体积**,主包占用为 0!*
235
247
 
236
248
  ### 方案 B:其他小程序平台(字节、百度等)
237
249