JavaScript本地存储工具类支持localStorage/sessionStorage双模式，自动序列化/反序列化、TTL过期控制、静默容错、配额异常处理及环境检测，API简洁易用。
在 JavaScript 中封装一个统一的本地存储读写工具类，核心是抽象 localStorage 和 sessionStorage 的重复操作，增强类型安全、错误处理、序列化/反序列化、过期控制等能力。下面是一个轻量、实用、可直接落地的实现方案。
基础结构：支持双存储 + 自动序列化
本地存储只能存字符串，每次读写都需手动 JSON.stringify / JSON.parse，容易出错。工具类应自动处理——写入时自动序列化，读取时自动尝试解析，失败则返回 null 或原始字符串（可配置）。
- 构造时指定存储类型：
'local'或'session' - 所有值默认按 JSON 存储；非 JSON 可显式传
raw: true跳过序列化 - 读取时对解析异常做静默容错，避免阻断业务逻辑
支持 TTL（带过期时间）的键值管理
原生 Storage 不支持过期，但可通过组合存储「值 + 过期时间戳」来模拟。工具类可提供 set(key, value, expires) 方法：
-
expires支持多种格式：毫秒数（如60 * 60 * 1000）、相对时间字符串（'2h'、'7d'）、Date实例 - 读取时自动检查是否过期，过期则自动删除并返回
null - 过期信息与主数据同 key 存储，例如
key对应值，key@exp存时间戳
统一错误处理与调试友好
Storage 在无痕模式、配额超限、跨域 iframe 等场景下可能抛异常（如 QuotaExceededError）。工具类应：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 所有方法包裹
try/catch，失败时返回undefined或抛出自定义错误（可开关） - 提供
isSupported()静态方法快速检测当前环境是否可用 - 开发环境下（
process.env.NODE_ENV === 'development'）记录警告日志，比如写入失败或解析失败
使用示例与 API 设计
封装后使用非常简洁：
// 创建 local storage 实例
const ls = new Storage('local');
<p>// 写入带 1 小时过期的数据
ls.set('user', { id: 123, name: 'Alice' }, '1h');</p><p>// 读取（自动解析、自动验期）
const user = ls.get('user'); // { id: 123, name: 'Alice' } 或 null</p><p>// 写入原始字符串（不 JSON 化）
ls.set('token', 'abc123', { raw: true });</p><p>// 清空全部（可选只清本前缀的 key）
ls.clear();</p><p>// 检查是否可用
if (!Storage.isSupported('local')) {
console.warn('localStorage 不可用，降级到内存缓存');
}
不复杂但容易忽略细节，关键是把「序列化」「过期」「容错」「环境适配」这几层逻辑收拢，让业务代码只关注「存什么、取什么、何时过期」。
