@adobe/helix-rum-enhancer

中文文档
2.51.0发布于 2026/10/29Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 3176

Helix RUM 增强器

中文使用文档
文档目录8 节
  1. 状态
  2. 使用量
  3. 这个 source 参数和 sourceSelector
  4. 发展
  5. 构建
  6. 测试
  7. 林特
  8. 剪取释放前

Helix RUM 增强器

将高级功能添加到 Helix RUM 收藏( 客户端)

状态

codecov GitHub Actions GitHub license GitHub issues semantic-release

使用量

这个库是用来配合和加载的 sampleRUM 函数在 螺旋工程 或者说 Helix RUM 联合来文。 。 。 .

它将增加以下新的检查站:

  • cwv: 核心网络生命号收藏
  • pagesviewed:帮助估计用户平均看到多少页的数字.
  • click: 单击文档中的任意位置
  • viewblock: 一个螺旋块已滚动到视图端口
  • viewmedia: Helix Media Bus 主持的一幅图像或视频被滚动到取景口
  • reload, (中文(简体) ), navigate, (中文(简体) ), enter: 取决于当前页面是如何访问的
  • formsubmit: 当提交表格时

这个 source 参数和 sourceSelector

这个 source 参数是可用于识别事件源的字符串. 它可以用来识别事件的来源,如按钮,链接,形式等. 它代表着一种理想化的CSS选择器,既可人读又具体,足以在文档中识别出事件源头,即使无法访问 角膜文档。 它被理想化了,因为它假装DOM会使用有简洁语义的现代HTML,即使实际文档使用 class 对事物的价值 以语义HTML元素更好地代表.

这个 sourceSelector 函数是使用 DOM 元素并返回描述函数 source 参数。 如果该元素具有 data-rum-source 属性,其值被用作 source 参数。 否则,该函数试图生成一个 source 基于元素标记名称、类名称和文本内容的参数.

A. 结构 source 参数如下:

<context> <element>#<identifier>

三部分都是可选的

context 实值

  • form 用于窗体元素
  • dialog 用于对话框元素,或固定位置且正高z-指数的母容器
  • .block-name 用于螺旋块
  • header, (中文(简体) ), footer, (中文(简体) ), nav, (中文(简体) ), aside 主要场地结构
  • #id 如果有容器标识,则作为倒置

element 实值

  • button 按钮,或看起来像按钮的链接(例如,有类) button 或者说 btn 或者说 cta(中文(简体) )
  • img 图像
  • video 视频
  • a 对于不是按钮的链接
  • input[type="text"] 用于输入元素(支持所有类型)
  • select, (中文(简体) ), textarea其他形式元素的等

identifier 实值

  • 页:1 id 元素的属性,如果提供
  • 首个 .class 如果有的话
  • 其它省略

即使一个 identifier 提供,如果 context 财务报告和审定财务报表 element 建议: source 参数更可读,更容易理解.

发展

构建

$ npm install

测试

$ npm test

林特

$ npm run lint

剪取释放前

释放由 语义释放,然后当 PR 合并到 main 或 1.x 树枝。 合并为 beta,将创建预发版.

版本与发布记录

@adobe/helix-rum-enhancer 共发布 157 个版本,首次发布于 2022/07/08;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.51.0latest2026/10/299 天前
2.50.12026/10/2711 天前
2.50.02026/07/263 个月前
2.49.02026/07/103 个月前
2.48.02026/07/093 个月前
2.47.32026/05/135 个月前

其他发布通道:release-1.x → 1.23.1,beta → 2.31.1-beta.1。

关于 @adobe/helix-rum-enhancer 的常见问题

@adobe/helix-rum-enhancer 是什么?

Helix RUM 增强器

如何安装 @adobe/helix-rum-enhancer?

在项目目录运行 npm install @adobe/helix-rum-enhancer,或使用 pnpm add / yarn add / bun add。

@adobe/helix-rum-enhancer 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adobe__helix-rum-enhancer 是否存在。

@adobe/helix-rum-enhancer 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@adobe/helix-rum-enhancer 可以商用吗?

@adobe/helix-rum-enhancer 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@adobe/helix-rum-enhancer 的下载量有多少?

根据 npm 官方下载统计,@adobe/helix-rum-enhancer 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,176 次,日均约 106 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adobe/helix-rum-enhancer 还在维护吗?

最新版本 2.51.0 发布于 2026/10/29(9 天前);至今共发布 157 个版本,其中过去 12 个月发布了 15 个;首次发布于 2022/07/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。