devLocalStorage 存储
devLocalStorage 是对浏览器 localStorage 的封装类,采用单例模式,确保在整个应用生命周期内只创建一个实例。通过简化 API 操作,它提供了更清晰、可维护的本地存储方案。
功能特点
- 单例模式:使用
getInstance()
保证全局只有一个LocalStorage
实例,避免重复创建实例的开销。 - JSON 自动解析与存储:封装了数据的序列化与反序列化逻辑,用户只需传入普通对象,无需手动调用
JSON.stringify
或JSON.parse
。 - 简化 API:只需调用
setItem
getItem
removeItem
即可完成存储、读取和删除数据的操作。 - 代码高可维护性:通过封装,将对 localStorage 的调用集中在一个类中,方便后续的维护和扩展。
核心功能
getItem(key: string): any
:传入键名,返回对应的值。若键不存在或数据无效,返回 null。setItem(key: string, value: any): void
:传入键名与值,将其存储在本地。支持存储对象、数组等复杂数据类型。removeItem(key: string): void
:根据键名删除对应的存储数据。
使用示例
ts
import { devLocalStorage } from 'devecoui-plus';
// 存储用户信息
devLocalStorage.setItem('user', { id: 1, name: 'Alice' });
// 获取用户信息
const user = devLocalStorage.getItem('user');
console.log('用户信息:', user);
// 删除用户信息
devLocalStorage.removeItem('user');