更新日志¶

@cloudcare/rum-uniapp 2.2.22（2026/08/25）¶

1. 新增 allowedTracingUrls，按完整请求 URL 匹配，支持字符串前缀、正则表达式、函数以及 { match, traceType }；
2. allowedTracingOrigins 标记为废弃兼容配置；两者同时存在时优先使用 allowedTracingUrls；
3. 修复抖音 navigation 路由归属，以及页面栈暂时为空时 View route 和 setData 指标缺失的问题。

@cloudcare/rum-miniapp 2.2.19（2026/08/25）¶

1. 新增 allowedTracingUrls，按完整请求 URL 匹配，支持字符串前缀、正则表达式、函数以及 { match, traceType }；
2. allowedTracingOrigins 标记为废弃兼容配置；两者同时存在时优先使用 allowedTracingUrls；
3. 修复抖音 navigation 路由归属，以及页面栈暂时为空时 View route 和 setData 指标缺失的问题。

@cloudcare/rum-uniapp 2.2.21（2026/08/20）¶

1. 新增页面首次渲染、FP、FCP、LCP、Ready 状态、页面退出原因和 setData 分段耗时等性能字段；
2. 新增 performance_supported、first_render_supported 能力字段，便于按平台实际支持情况计算覆盖率和白屏候选；
3. 新增 launch_attempt 启动尝试事件，作为原生启动性能 entry 的覆盖率分母；
4. 按 route、pageId 和最新 navigationStart 归属性能 entry，避免快速切页、同路由重建和延迟回调造成跨页面污染；
5. 修复网络类型写入字段不一致的问题。

@cloudcare/rum-miniapp 2.2.18（2026/08/20）¶

1. 新增页面首次渲染、FP、FCP、LCP、Ready 状态、页面退出原因和 setData 分段耗时等性能字段；
2. 新增 performance_supported、first_render_supported 能力字段，便于按平台实际支持情况计算覆盖率和白屏候选；
3. 新增 launch_attempt 启动尝试事件，作为原生启动性能 entry 的覆盖率分母；
4. 按 route、pageId 和最新 navigationStart 归属性能 entry，避免快速切页、同路由重建和延迟回调造成跨页面污染。

@cloudcare/rum-uniapp 2.2.20（2026/08/11）¶

1. 新增 allowTraceHeaderWithoutSession 配置，默认值为 false；开启后，当前 Session 未命中 RUM 采样时，命中 allowedTracingOrigins 的请求仍会注入 Trace Header，但不会因此强制采样或上报该 Session 的 RUM 数据。

@cloudcare/rum-miniapp 2.2.17（2026/08/11）¶

1. 新增 allowTraceHeaderWithoutSession 配置，默认值为 false；开启后，当前 Session 未命中 RUM 采样时，命中 allowedTracingOrigins 的请求仍会注入 Trace Header，但不会因此强制采样或上报该 Session 的 RUM 数据。

@cloudcare/rum-miniapp 2.2.16（2026/07/28）¶

1. 新增远程配置能力，支持异步更新采样率、服务、环境、版本、Action 和链路追踪相关配置；
2. 新增 getRemoteConfiguration()，用于读取本次初始化缓存的远程配置；
3. 新增 setForcedSession()，支持按用户或业务条件强制采集当前 Session；
4. 新增 sessionSampleRate 配置，兼容 Browser SDK 的采样率命名；
5. Session 按 applicationId 独立存储，并完善空闲续期、最长时长和历史事件归属；
6. 请求与下载代理保持业务调用原始返回值及 Promise 行为；
7. 补充 TypeScript 类型声明，以及请求响应、URL 查询串和启动参数的数据采集控制。

2023/5/22¶

1. 新增启动小程序的 query 参数：app_launch_query；
2. 新增自定义添加 Error。

2022/9/29¶

初始化参数新增 isIntakeUrl 配置，用于根据请求资源 URL 判断是否需要采集对应资源数据，默认都采集。

2022/3/29¶

1. 新增 traceType 配置，配置链路追踪工具类型，如果不配置默认为 ddtrace。目前支持 ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent 6 种数据类型；

2. 新增 allowedTracingOrigins 允许注入 Trace 采集器所需 header 头部的所有请求列表。可以是请求的 origin，也可以是正则。