UD5工具箱
快照测试（Snapshot Testing）
快照测试是 Jest 提供的一种自动化回归测试方法。它在首次运行时捕获被测对象（如 React 组件渲染结果或函数返回值）的序列化输出，并将其保存为快照文件。后续每次运行测试时，Jest 会将当前输出与已保存的快照进行比对。如果两者完全一致则测试通过，如果存在差异则测试失败并提示开发者审查变更。快照测试特别适合验证 UI 组件的渲染输出是否发生了非预期的变化。
快照文件（.snap File）
快照文件是 Jest 将测试运行时捕获的序列化输出持久化存储后生成的文件，通常以 .snap 为扩展名。该文件存储在测试文件同级目录下的 __snapshots__ 文件夹中，文件名与测试文件对应。文件内容使用 JavaScript 模板字面量语法（exports[`test name`] = ...）组织，每个代码块对应一个 expect().toMatchSnapshot() 调用的输出结果。快照文件应纳入版本控制管理。
过时快照（Outdated Snapshot）
当被测代码发生变化导致输出与已保存的快照不一致时，Jest 会将该快照标记为过时（outdated）。这并不一定意味着代码有 Bug，也可能是开发者有意修改了组件行为或样式。过时快照需要开发者审查差异后决定是更新快照以接受新输出，还是修复代码以恢复原有输出。使用 jest --updateSnapshot 命令或在 watch 模式下按 u 键可以更新过时快照。
差异对比（Diff Comparison）
差异对比是指将两个文本或数据结构进行逐行或逐字符比较，找出它们之间的不同之处的过程。在快照测试的语境中，差异对比特指将当前测试输出与已保存快照进行比较，标记出新增、删除和修改的内容行。本工具提供的差异对比功能将 Jest 命令行的枯燥文本输出转化为可视化的颜色高亮结果，帮助开发者快速识别变更所在位置和变更幅度。
并排视图（Side-by-Side View）
并排视图是差异对比工具中最常用的可视化模式之一。它将两个待比较的文件内容分别放置在左右两个面板中，相同行在水平方向上对齐显示，差异行则用不同背景颜色标注以示区分。并排视图的优势在于可以同时看到两个版本的完整上下文信息，非常适合需要深入理解变更前后代码结构变化的场景。本工具的并排视图支持同步滚动浏览。
统一视图（Unified View）
统一视图是另一种差异可视化模式，它将两个版本的内容合并为单栏显示。未变更的行以普通样式呈现，新增的行以绿色背景和加号前缀标记，删除的行以红色背景和减号前缀标记。统一视图相比并排视图更加紧凑，适合快速浏览变更概要。在统一视图模式下，变更行与其上下文交替排列，方便理解每处变更发生的具体位置。
序列化（Serialization）
在 Jest 快照测试中，序列化是指将 JavaScript 对象、DOM 节点或 React 组件树转换为可存储的字符串表示形式的过程。Jest 内置了针对 React 组件的特殊序列化器（react-test-renderer），可以将组件的虚拟 DOM 树转换为易于阅读的文本格式。序列化质量直接影响快照文件的可读性和可维护性，良好的序列化应保留关键结构信息而过滤掉不必要的细节。
自定义序列化器（Custom Serializer）
自定义序列化器允许开发者覆盖 Jest 默认的快照序列化行为，对特定类型的值进行自定义格式化输出。通过 jest.config 中的 snapshotSerializers 配置项可以注册自定义序列化器。常见用途包括：过滤动态值（如时间戳、随机 ID）、格式化特定库的对象输出（如日期对象、Map 结构）、压缩过长的输出以保持快照简洁。自定义序列化器是提升快照测试质量的重要手段。
快照冲突（Snapshot Conflict）
快照冲突是指在 Git 多人协作开发中，两个或多个分支分别修改了同一个快照文件的不同部分，合并时产生的版本冲突。由于快照文件通常包含大量序列化内容，Git 的自动合并算法经常无法正确处理快照文件的冲突，需要开发者手动解决。解决快照冲突的一般流程是：先合并代码变更，然后运行测试确保通过，最后用 jest -u 重新生成快照以消除冲突标记。
toMatchSnapshot()
toMatchSnapshot() 是 Jest 提供的核心快照匹配断言方法。当在测试中调用 expect(value).toMatchSnapshot() 时，Jest 会将 value 序列化后的结果与已保存的快照进行比较。首次运行时该方法会创建新快照并标记测试为"新的快照已写入"。后续运行时进行比对，不匹配则测试失败。该方法还支持可选的配置参数，如自定义快照名称、属性匹配器等。
回归测试（Regression Testing）
回归测试是指在软件修改后重新运行已有测试，确保修改没有引入新的缺陷或破坏原有功能的测试活动。快照测试本质上是一种自动化回归测试手段：通过比对组件输出的快照变化，开发者可以快速发现非预期的 UI 或数据结构变更。快照测试将回归测试的成本从编写详细的断言降低到了保存和审查输出变化，特别适合验证复杂的树形结构输出。