TinyBase 时间获取机制优化：支持自定义时钟函数

背景

在现代Web应用开发中，时间管理是一个看似简单实则复杂的问题。TinyBase作为一个轻量级的状态管理库，其内部实现依赖于精确的时间戳来支持HLC(混合逻辑时钟)等机制。然而浏览器环境中的时间获取存在几个固有缺陷：

1. 依赖操作系统时间，而并非所有系统都能保证时间同步
2. 浏览器出于隐私保护考虑(如Firefox的privacy.resistFingerprinting设置)会对时间戳添加抖动或舍入(如100ms精度)
3. 测试环境下需要模拟静态时间

这些问题可能导致HLC机制出现异常，虽然HLC本身具备一定的时间偏差容错能力，但仍需基础时间大致准确。

解决方案

TinyBase最新版本(6.1.0 beta)引入了一个重要改进：允许开发者注入自定义的时间获取函数。这一设计通过以下方式实现：

createMergeableStore({
  getWallClockTime: () => number // 自定义时间获取函数
})

当不提供此参数时，库会默认使用标准的Date.now()方法，确保向后兼容。

技术实现细节

1. 函数注入模式：采用配置参数而非全局变量或猴子补丁(monkey-patch)，保持了代码的纯净性和可测试性

2. HLC集成：混合逻辑时钟机制现在可以基于开发者提供的时间源工作，这对于需要高精度时间同步的应用尤为重要

3. 测试便利性：取代了原有的HLC_TIME全局变量方案，使测试代码更加规范和可控

应用场景

1. NTP同步系统：应用可以集成NTP客户端，提供网络同步的精确时间

2. 时间敏感应用：金融交易、实时协作等对时间精度要求高的场景

3. 测试环境：可以轻松模拟特定时间点，简化时间相关测试用例

4. 隐私保护：统一应用内的时间获取策略，避免浏览器指纹防御机制的影响

最佳实践

// 使用NTP同步时间示例
import { createSyncClient } from 'ntp-client'

const ntp = createSyncClient('pool.ntp.org')

const store = createMergeableStore({
  getWallClockTime: () => ntp.now()
})

// 测试环境使用固定时间
const testStore = createMergeableStore({
  getWallClockTime: () => 1715000000000 // 固定测试时间戳
})

总结

TinyBase的这一改进虽然看似微小，但为时间敏感型应用提供了关键的基础设施支持。通过解耦时间获取逻辑，开发者可以：

• 自由选择最适合的时间源
• 确保应用内时间一致性
• 提升测试的可控性
• 适应特殊的隐私保护需求

这体现了TinyBase在设计上对灵活性和实用性的平衡，为复杂场景下的状态管理提供了更强大的支持。