@adobe/helix-rum-js

中文文档
2.17.0发布于 2026/09/17Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 6854

Helix RUM 联合来文

中文使用文档
文档目录10 节
  1. 状态
  2. 将您的网站与 RUM 连接
  3. 内容安全政策
  4. 测试设置
  5. 边际交付服务项目
  6. 发展
  7. 构建
  8. 测试
  9. 林特
  10. 释放

AEM RUM 联合来文

JavaScript 的 AEM RUM 事件生成器

状态

codecov GitHub Actions GitHub license GitHub issues semantic-release

将您的网站与 RUM 连接

如果您的网站没有使用 AEM 边缘服务构建,建议您单独设置 RUM .

要做到这一点,只需在您的页面中添加以下脚本.

<script defer type="text/javascript" src="https://rum.hlx.page/.rum/@adobe/helix-rum-js@^2/dist/rum-standalone.js"></script>

如果您想要指示一个404响应,请包含相同的脚本,但将状态数据属性设置为404.

<script defer type="text/javascript" src="https://rum.hlx.page/.rum/@adobe/helix-rum-js@^2/dist/rum-standalone.js" data-status="404"></script>

如果你理解高性能页面的细节,也许最好在后装入脚本 长效 事件

检查以下链接 高级配置选项。 。 。 .

此外,您还可以将您的网站与 RUM 使用 Google 标签管理器

内容安全政策

如果您的网站执行 内容安全政策 必须确保 来源 https://rum.hlx.page 既允许作为脚本来源,也允许作为 navigator.sendBeacon API (英语).

测试设置

  1. 访问您网站上包含 RUM 脚本的一页 .

  2. 将请求参数添加到url rum=on 重新装入页面

  3. 打开浏览器控制台并检查 ping 正在写入信件 .

    ping-messages-in-console

  4. 打开浏览器的网络标签并使用 POST 用于域的方法 rum.hlx.page 答复状态 201

    rum-requests-in-network-tab

边际交付服务项目

请注意,与Adobe Edge送货服务公司共同实施的网站,基于锅炉板,已经用RUM配有仪器.

关于边际交付项目中的 RUM 的更详细信息,从以前的版本 RUM 升级,或定制选项, 您可以检查页面 RUM 边际交付服务项目

发展

构建

$ npm install

独立构建

$ npm run build-standalone

测试

$ npm test

林特

$ npm run lint

释放

在GitHub Actions中通过语义放出进行放出. 软件包使用 国家预防机制信任的出版商 支持,以便国家预防机制不会 接受任何其他软件包的出版商.

版本与发布记录

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

版本发布日期距今
2.17.0latest2026/09/171 个月前
2.15.32026/06/174 个月前
2.15.22026/06/154 个月前
2.15.12026/06/154 个月前
2.15.02026/05/215 个月前
2.14.42026/05/135 个月前

其他发布通道:release-1.x → 1.9.0。

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

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

Helix RUM 联合来文

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

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

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

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

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

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

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

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

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

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

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

最新版本 2.17.0 发布于 2026/09/17(1 个月前);至今共发布 61 个版本,其中过去 12 个月发布了 11 个;首次发布于 2022/02/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。