Clock 组件 Mock 时间依赖解决单元测试痛点【测试哲学】
单元测试中`newDate()`等时间依赖因系统时钟不可控导致断言失败。解决思路是将时间抽取为可注入的`useClock`Hook，测试时传入固定值实现可控，生产环境自动刷新。需注意使用`jest.useFakeTimers`后手动调用`advanceTimersByTime`推进定时器，并基于UTC处理逻辑时区，避免全局污染。
聊测试时踩过时间依赖的坑，大概每个前端都经历过。尤其当代码里出现 new Date() 或 Date.now() 时，单元测试就会变得像在赌运气——今天跑能过，明天跑可能就失败了，全看系统时钟的脸色。
问题本质在于：真实时间是全局共享的、不可控的外部状态。测试一个包含“当前时间”判断的逻辑，等于在跟一个看不见的对手博弈。解决思路其实不复杂：把时间这个依赖从代码里“抽”出来，变成可注入、可控制的东西。下面把这套做法拆开看看。
为什么 new Date() 在单元测试里总不按预期走
因为真实时间不可控，每次跑测试都可能因系统时钟差异导致断言失败。比如测试“今天生成的订单号是否含当前日期”，new Date() 返回的是运行时刻，不是你写用例时想模拟的那个“今天”。
更麻烦的是，某些逻辑依赖时间差（如过期判断）、定时器（setTimeout）、或全局时间戳（Date.now()），直接 new 一个实例根本没法稳定复现。
踩过坑的人都知道，处理这个问题有几个原则值得记住：
- 不要 patch 全局
Date构造函数——它影响整个测试环境，容易污染其他用例 - 避免在组件内部直接调用
new Date()或Date.now()——耦合太紧，无法注入控制点 - 优先把时间获取逻辑抽成可替换的依赖，而不是硬编码在 render 或生命周期里
React 中用 Clock 组件封装时间依赖的实操方式
所谓 Clock，在这里不是指一个显示时间的 UI 组件，而是一个提供时间值的 React Hook 或 Context Provider。它的核心价值在于：把“当前时间”变成可注入、可 mock 的 prop 或 context 值。
具体做法很直观——定义一个 useClock() Hook，内部默认读取 Date.now()，但允许传入 now 参数覆盖：
function useClock({ now } = {}) {
const [time, setTime] = useState(now ?? Date.now());
useEffect(() => {
if (now !== undefined) return;
const timer = setInterval(() => setTime(Date.now()), 1000);
return () => clearInterval(timer);
}, [now]);
return time;
}
这样在测试中就能固定时间：
render(); // 2024-05-30 00:00:00
- 生产环境不传
now，自动刷新；测试时传死值，完全可控 - 如果组件需要格式化时间（如
toLocaleDateString()），也建议把Intl.DateTimeFormat实例或格式化函数作为 prop 注入，避免依赖本地时区 - 关键点：
useEffect中的定时器只在now未定义时启用，否则会跳过——这是隔离的核心
Mock setTimeout 和 setInterval 时别只 stub 不 advance
很多测试库（如 Jest）提供了 jest.useFakeTimers()，很多人以为只要调了这句，时间就“冻结”了，定时器就能自动触发。但事实并非如此——它只是冻结时间，并不会自动推进。如果你写了 setTimeout(() => doX(), 5000)，不手动调用 jest.advanceTimersByTime(5000)，回调永远不会触发，测试要么超时要么跳过。
- 推荐用
jest.useFakeTimers('modern')替代旧版，它支持advanceTo和更精确的微任务调度 - 对于依赖轮询的组件（如倒计时、心跳检测），必须显式调用
advanceTimersByTime()或runAllTimers()，否则逻辑不会被执行 - 测试结束后记得调用
jest.useRealTimers()——尤其在 afterEach 里，否则下一个测试可能还在 fake 模式下，行为会变得很诡异
时区和夏令时是 Clock Mock 最容易漏掉的坑
本地开发机可能是 CST，CI 环境默认 UTC，而用户浏览器又各自有本地时区。单纯 mock 时间戳（毫秒数）能绕过时区问题，但一旦涉及 toLocaleTimeString()、getHours() 这类方法，结果就不受控制了。
解决方案不是禁止使用这些 API，而是统一约定时间上下文的边界：
- 所有业务时间逻辑基于 UTC 处理（如有效期判断、日志时间戳），避免时区干扰
- UI 层才做时区转换，且通过明确的
timeZoneprop 控制，例如： - 测试时用
Intl.DateTimeFormat的resolvedOptions().timeZone断言是否生效，比直接 expect 字符串更可靠
说到底，真正难的不是怎么 mock，而是决定哪一层该信任时间、哪一层该隔离时间——Clock 的价值不在组件本身，而在帮你划清这条线。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
