测试本地缓存模块应使用内存对象模拟localstorage/sessionstorage接口,隔离真实环境、可控读写、验证序列化逻辑;需覆盖类型安全、边界行为及前缀处理,并在集成测试中按需启用真实存储。

测试依赖本地缓存(如 localStorage 或 sessionStorage)的持久化存储管理模块,核心是**隔离真实浏览器环境、可控模拟读写行为、并验证数据序列化/反序列化逻辑**。不能直接在真实 localStorage 上跑单元测试,否则会污染环境、产生副作用、难以断言。
用内存对象模拟 Storage 接口
最常用且可靠的方式是用一个普通 JavaScript 对象替代真实的 localStorage,并实现其关键方法(getItem、setItem、removeItem、clear)。这样测试完全可控,无需浏览器上下文,也兼容 Node.js 环境(如 Jest 默认运行在 JSDOM 或纯 Node 模式)。
示例(Jest 中):
const createMockStorage = () => {
const store = new Map();
return {
getItem: (key) => store.get(key) || null,
setItem: (key, value) => store.set(key, String(value)),
removeItem: (key) => store.delete(key),
clear: () => store.clear(),
key: (n) => Array.from(store.keys())[n] || null,
length: store.size,
};
};
// 在 test setup 中替换
beforeEach(() => {
global.localStorage = createMockStorage();
});
注意:确保模块代码中访问的是 global.localStorage(或传入的 storage 实例),而不是硬编码依赖全局变量——推荐将 storage 作为可注入依赖(例如构造函数参数或配置项)。
验证序列化与类型安全逻辑
很多持久化模块会对值做 JSON 序列化(如存对象时 JSON.stringify,取时 JSON.parse)。测试需覆盖:
- 存入普通字符串、数字、布尔值、null、数组、对象,读取后是否还原一致
- 存入 undefined、function、Date、RegExp 等无法 JSON 化的值时,是否优雅降级(如抛错或忽略)
- 解析失败(如存储了损坏的 JSON 字符串)时是否返回默认值或
null,不抛未捕获异常
例如:
test('handles invalid JSON gracefully', () => {
localStorage.setItem('broken', '{ "key": ');
expect(storageModule.get('broken')).toBeNull(); // 或返回默认值
});
测试清理与边界行为
真实 localStorage 有容量限制(通常 ~5–10MB),但测试中更关注逻辑边界:
- 调用
clear()后,所有键是否真正清空 -
removeItem删除不存在的键是否静默成功(符合规范) - 多次
setItem同一键,是否覆盖而非追加 - 键名含特殊字符(如空格、斜杠、Unicode)是否正常处理(localStorage 本身支持)
尤其注意:某些封装模块会自动添加前缀(如 myapp:user),测试时要检查前缀拼接与剥离逻辑是否准确。
集成测试中可选:用真实 localStorage(仅限浏览器环境)
如果模块重度依赖 Storage 事件(storage event)或需要验证跨 tab 同步行为,可在端到端(E2E)或浏览器内单元测试(如 Karma + Chrome)中启用真实 localStorage。但务必:
- 每个测试用唯一 key 前缀(如
test_${Math.random().toString(36).substr(2, 9)})避免冲突 - 测试结束后调用
localStorage.clear()或按前缀批量清理 - 不用于 CI 的纯 Node 环境——这类测试应单独归类,非主单元测试集
简单说:单元测试用 mock,集成/E2E 需行为验证时再上真家伙。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











