封装LocalStorage因原生API仅支持字符串、无过期机制、缺乏错误处理;通过StorageUtil类实现序列化、异常捕获、过期控制,提升安全性与易用性,并可扩展监听、加密等功能。

前端开发中,经常需要在浏览器端保存一些用户数据,比如用户偏好、登录状态或表单内容。LocalStorage 提供了简单易用的本地存储方案,但原生 API 操作不够友好,缺乏类型支持和异常处理。因此,封装一个更安全、易用的 LocalStorage 工具类非常有必要。
虽然 LocalStorage 的 API 很简单(setItem、getItem、removeItem),但它存在几个痛点:
封装一个 StorageUtil 类,解决类型转换和异常问题:
class StorageUtil {
static set(key, value) {
try {
const serialized = JSON.stringify(value);
localStorage.setItem(key, serialized);
} catch (error) {
console.warn(`保存 ${key} 失败`, error);
}
}
<p>static get(key) {
try {
const item = localStorage.getItem(key);
return item ? JSON.parse(item) : null;
} catch (error) {
console.warn(<code>读取 ${key} 失败</code>, error);
return null;
}
}</p><p>static remove(key) {
localStorage.removeItem(key);
}</p><p>static clear() {
localStorage.clear();
}
}</p>这样调用就简洁多了:
立即学习“Java免费学习笔记(深入)”;
StorageUtil.set('user', { name: 'Alice', age: 25 });
const user = StorageUtil.get('user'); // 直接返回对象
LocalStorage 本身不支持过期,但我们可以通过额外字段模拟:
class StorageUtil {
// ... 其他方法
<p>static setWithExpire(key, value, ttlMs) {
const now = Date.now();
const item = {
value,
expire: now + ttlMs
};
try {
localStorage.setItem(key, JSON.stringify(item));
} catch (error) {
console.warn(<code>保存带过期的 ${key} 失败</code>, error);
}
}</p><p>static getWithExpire(key) {
try {
const itemStr = localStorage.getItem(key);
if (!itemStr) return null;</p><pre class='brush:php;toolbar:false;'> const item = JSON.parse(itemStr);
if (Date.now() > item.expire) {
localStorage.removeItem(key);
return null;
}
return item.value;
} catch (error) {
console.warn(`读取带过期的 ${key} 失败`, error);
return null;
}} }
使用示例:
// 10分钟后过期
StorageUtil.setWithExpire('token', 'abc123', 10 * 60 * 1000);
const token = StorageUtil.getWithExpire('token');
LocalStorage 支持 storage 事件,可用于跨标签页通信:
window.addEventListener('storage', (event) => {
if (event.key === 'user') {
console.log('用户数据被其他页面修改:', event.newValue);
}
});
注意:当前页面对 LocalStorage 的修改不会触发该事件。
基本上就这些。通过简单封装,我们让 LocalStorage 更安全、易用,还能扩展出过期控制等实用功能。实际项目中可根据需求进一步加入命名空间、加密存储等功能。不复杂但容易忽略细节。
以上就是JavaScript数据持久化_LocalStorage封装的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号