# @chromaui/rrweb-snapshot 中文文档

规范地址：https://npmcn.com/package/%40chromaui/rrweb-snapshot/

版本：2\.0\.0-alpha\.19-noAbsolute
npm 元数据更新时间：2026-04-27T15:19:42.234Z
中文译文更新时间：2026-11-09T15:13:12.267Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chromaui/rrweb-snapshot
原文对照：https://npmcn.com/package/%40chromaui/rrweb-snapshot/?lang=original
项目主页：https://github.com/chromaui/rrweb/tree/master/packages/rrweb-snapshot#readme
源码仓库：https://github.com/chromaui/rrweb

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.9 MB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2023-04-06T10:21:43.451Z
- 最新版本发布：2026-04-27T15:19:41.672Z
- 近 30 天下载量：1302383（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 1 个）

## 中文简介

rrweb的组件来拍摄 DOM 的快照, 也就是 DOM 序列器

## 安装

```sh
npm install @chromaui/rrweb-snapshot
```

也可以使用：`pnpm add @chromaui/rrweb-snapshot`、`yarn add @chromaui/rrweb-snapshot`、`bun add @chromaui/rrweb-snapshot`

## README

# rrweb- snapshot 图像

[![Build Status](https://travis-ci.org/rrweb-io/rrweb.svg?branch=master)](https://travis-ci.org/rrweb-io/rrweb) [![Join the chat at slack](https://img.shields.io/badge/slack-@rrweb-teal.svg?logo=slack)](https://join.slack.com/t/rrweb/shared_invite/zt-siwoc6hx-uWay3s2wyG8t5GpZVb8rWg)

将 DOM 拍摄成一个状态和可序列的数据结构 . 另外,提供通过快照重建DOM的能力.

## API 密码

此模块导出如下方法 :

### 简介

`snapshot` 将穿越 DOM 并返回能够代表当前 DOM 的状态和可序列的数据结构 **视图**。 。 。 .

在快照期间将做一些事情:

1.  将一些 DOM 状态插入到 HTML 属性中,例如 HTML InputElement 的值.
2.  将脚本标签转换为 `noscript` 避免脚本被执行的标记.
3.  尝试内置样式表,以确保可以使用本地样式表 .
4.  使href,src,CSS中的相对路径成为绝对路径.
5.  给每个节点一个ID,并在快照完成后返回ID节点地图.

#### 重建

`rebuild` 将会根据拍摄的快照构建DOM.

重建期间将做一些事情:

1.  如果节点是元素,则添加数据驱动属性.
2.  创建一些额外的DOM节点,如文本节点,以设置内置 CSS 和一些状态.
3.  如果节点拥有一些额外的孩子DOM,则添加数据外孩子索引属性.

#### 序列化 NodeWithId 软件

`serializeNodeWithId` 可将节点序列化为带有 id 的快照格式.

#### 构建节点WithSN

`buildNodeWithSN` 从序列化节点建立DOM,并将序列化信息存储于 `mirror.getMeta(node)`。 。 。 .

## 发起人

[成为提案国](https://opencollective.com/rrweb#sponsor) 并在Github的读取器上找到你的标志 链接到你的网站.

### 黄金赞助商

[![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/0/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/0/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/1/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/1/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/2/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/2/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/3/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/3/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/4/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/4/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/5/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/5/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/gold-sponsor/6/avatar.svg?requireActive=false&avatarHeight=225)](https://opencollective.com/rrweb/tiers/gold-sponsor/6/website?requireActive=false)

### 银色赞助商

[![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/0/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/0/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/1/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/1/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/2/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/2/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/3/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/3/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/4/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/4/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/5/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/5/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/silver-sponsor/6/avatar.svg?requireActive=false&avatarHeight=158)](https://opencollective.com/rrweb/tiers/silver-sponsor/6/website?requireActive=false)

### 青铜赞助商

[![sponsor](https://opencollective.com/rrweb/tiers/sponsors/0/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/0/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/1/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/1/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/2/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/2/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/3/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/3/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/4/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/4/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/5/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/5/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/6/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/6/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/7/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/7/website?requireActive=false) [![sponsor](https://opencollective.com/rrweb/tiers/sponsors/8/avatar.svg?requireActive=false&avatarHeight=70)](https://opencollective.com/rrweb/tiers/sponsors/8/website?requireActive=false)

### 备份

[![](https://opencollective.com/rrweb/tiers/backers.svg?avatarHeight=36)](https://opencollective.com/rrweb#sponsor)

## 核心小组成员

<table><tbody><tr><td align="center"><a href="https://github.com/Yuyz0112" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/13651389?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>尤伊兹0112</b></sub><br><br></a></td><td align="center"><a href="https://github.com/YunFeng0817" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/27533910?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>云凤</b></sub><br><br></a></td><td align="center"><a href="https://github.com/eoghanmurray" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/156780?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>eoghanmurray (英语)</b></sub><br><br></a></td><td align="center"><a href="https://github.com/Juice10" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/4106?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>果汁10号</b></sub><br><sub>为 rrweb 咨询打开</sub></a></td></tr></tbody></table>

## 谁在用rrweb?

<table><tbody><tr><td align="center"><a href="http://www.smartx.com/" rel="nofollow noopener noreferrer"><img src="https://www.rrweb.io/logos/smartx.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://posthog.com/?utm_source=rrweb&amp;utm_medium=sponsorship&amp;utm_campaign=open-source-sponsorship" rel="nofollow noopener noreferrer"><img src="https://www.rrweb.io/logos/posthog.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://statcounter.com/session-replay/" rel="nofollow noopener noreferrer"><img src="https://statcounter.com/images/logo-statcounter-arc-blue.svg" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://recordonce.com/" rel="nofollow noopener noreferrer"><img alt="Smart screen recording for SaaS" src="https://uploads-ssl.webflow.com/5f3d133183156245630d4446/5f3d1940abe8db8612c23521_Record-Once-logo-554x80px.svg" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td></tr><tr><td align="center"><a href="https://cux.io/" rel="nofollow noopener noreferrer"><img alt="The first ever UX automation tool" src="https://cux.io/cux-logo.svg" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://remsupp.com/" rel="nofollow noopener noreferrer"><img alt="Remote Access &amp; Co-Browsing" src="https://remsupp.com/images/logo.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://highlight.io/" rel="nofollow noopener noreferrer"><img alt="The open source, fullstack Monitoring Platform." src="https://github.com/highlight/highlight/raw/main/highlight.io/public/images/logo.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://analyzee.io/" rel="nofollow noopener noreferrer"><img alt="Comprehensive data analytics platform that empowers businesses to gain valuable insights and make data-driven decisions." src="https://cdn.analyzee.io/assets/analyzee-logo.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td></tr><tr><td align="center"><a href="https://requestly.io/" rel="nofollow noopener noreferrer"><img alt="Intercept, Modify, Record &amp; Replay HTTP Requests." src="https://github.com/requestly/requestly/assets/16779465/652552db-c867-44cb-9bb5-94a2026e04ca" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://gleap.io/" rel="nofollow noopener noreferrer"><img alt="In-app bug reporting &amp; customer feedback platform." src="https://assets-global.website-files.com/6506f3f29c68b1724807619d/6506f56010237164c6306591_GleapLogo.svg" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://uxwizz.com/" rel="nofollow noopener noreferrer"><img alt="Self-hosted website analytics with heatmaps and session recordings." src="https://github.com/UXWizz/public-files/raw/main/assets/logo.png" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td><td align="center"><a href="https://www.howdygo.com/" rel="nofollow noopener noreferrer"><img alt="Interactive product demos for small marketing teams" src="https://assets-global.website-files.com/650afb446f1dd5bd410f00cc/650b2cec6188ff54dd9b01e1_Logo.svg" width="195px" loading="lazy" decoding="async" referrerpolicy="no-referrer"></a></td></tr></tbody></table>

## 常见问题

### @chromaui/rrweb-snapshot 是什么？

rrweb的组件来拍摄 DOM 的快照, 也就是 DOM 序列器

### 如何安装 @chromaui/rrweb-snapshot？

在项目目录运行 npm install @chromaui/rrweb-snapshot，或使用 pnpm add / yarn add / bun add。

### @chromaui/rrweb-snapshot 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chromaui/rrweb-snapshot 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @chromaui/rrweb-snapshot 可以商用吗？

@chromaui/rrweb-snapshot 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chromaui/rrweb-snapshot 的下载量有多少？

根据 npm 官方下载统计，@chromaui/rrweb-snapshot 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,302,383 次，日均约 43,413 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chromaui/rrweb-snapshot 还在维护吗？

最新版本 2\.0\.0-alpha\.19-noAbsolute 发布于 2026/04/27（6 个月前）；至今共发布 9 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/04/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。