yy-storage

统一的本地存储管理工具，支持过期时间、版本控制等功能。

安装

npm install yy-storage

使用

基础用法

import storage from 'yy-storage';

// 设置值
storage.set('user', { name: 'John', age: 30 });

// 获取值
const user = storage.get('user');
// { name: 'John', age: 30 }

// 移除值
storage.remove('user');

// 检查是否存在
if (storage.has('user')) {
  // ...
}

SessionStorage

import { sessionStore } from 'yy-storage';

sessionStore.set('temp', 'value');
const temp = sessionStore.get('temp');

带过期时间的存储

import storage from 'yy-storage';

// 设置 30 分钟后过期
storage.setWithExpire('token', 'abc123', 30);

// 30 分钟后自动失效
setTimeout(() => {
  const token = storage.get('token'); // null
}, 31 * 60 * 1000);

自定义存储实例

import { createStorage } from 'yy-storage';
import logger from 'logger';

// 创建自定义前缀的存储
const myStorage = createStorage('myapp_', localStorage, logger);

myStorage.set('key', 'value');

API

StorageManager 类

方法

• set(key, value, options) - 设置存储
• get(key, defaultValue) - 获取存储
• remove(key) - 移除存储
• clear() - 清空所有带前缀的存储
• keys() - 获取所有键名
• has(key) - 检查键是否存在
• setWithExpire(key, value, expireMinutes) - 设置带过期时间的存储
• getSize() - 获取存储大小（KB）

createStorage(prefix, storageType, logger)

创建自定义存储实例。

参数：

• prefix (string) - 键名前缀
• storageType (Storage) - 存储类型，默认 localStorage
• logger (Logger) - 日志实例（可选）

特性

• ✅ 自动版本控制
• ✅ 过期时间支持
• ✅ 键名前缀隔离
• ✅ 错误处理
• ✅ TypeScript 支持
• ✅ 可配置日志