使用 js-cookie 和 localStorage/sessionStorage 构建高效的浏览器缓存管理

一、localStorage 和 sessionStorage 的基本概念
  • localStorage:用于长期存储数据,即使关闭浏览器或重启计算机后仍然存在。适合保存用户设置、偏好等不需要频繁更新的信息。
  • sessionStorage :与 localStorage 类似,但数据仅在当前会话期间有效,即当页面被关闭时数据会被清除。适用于临时性的会话信息,如购物车内容。

两者的主要区别在于数据的生命周期不同,因此在实际应用中可以根据需求选择合适的存储方式。

js-cookie 是一个轻量级的 JavaScript 库,提供了简洁的 API 来读取、写入和删除 Cookies。相比于原生的 document.cookie 接口,js-cookie 更加易用且功能丰富,支持自动编码/解码、路径和域设置等功能。

三、构建统一的缓存管理工具

为了简化 localStorage 和 sessionStorage 的使用,并集成 js-cookie 对 Cookies 的操作,设计了两个模块:Local 和 Session。每个模块都包含了四个核心方法:set, get, remove, 和 clear。此外,为了确保键名的一致性和可维护性,定义了一个 setKey 方法来为每个键添加前缀。

1. Local 模块 - 浏览器永久缓存
typescript 复制代码
import Cookies from 'js-cookie';

/**
 * window.localStorage 浏览器永久缓存
 */
export const Local = {
	// 设置键名前缀
	setKey(key: string) {
		// @ts-ignore
		return `${__NEXT_NAME__}:${key}`;
	},
	// 设置永久缓存
	set<T>(key: string, val: T) {
		window.localStorage.setItem(Local.setKey(key), JSON.stringify(val));
	},
	// 获取永久缓存
	get(key: string) {
		let json = <string>window.localStorage.getItem(Local.setKey(key));
		return json ? JSON.parse(json) : null;
	},
	// 移除永久缓存
	remove(key: string) {
		window.localStorage.removeItem(Local.setKey(key));
	},
	// 移除全部永久缓存
	clear() {
		window.localStorage.clear();
	},
};
2. Session 模块 - 浏览器临时缓存
typescript 复制代码
/**
 * window.sessionStorage 浏览器临时缓存
 */
export const Session = {
	// 设置临时缓存
	set<T>(key: string, val: T) {
		if (key === 'token') return Cookies.set(key, val as string);
		window.sessionStorage.setItem(Local.setKey(key), JSON.stringify(val));
	},
	// 获取临时缓存
	get(key: string) {
		if (key === 'token') return Cookies.get(key);
		let json = <string>window.sessionStorage.getItem(Local.setKey(key));
		return json ? JSON.parse(json) : null;
	},
	// 移除临时缓存
	remove(key: string) {
		if (key === 'token') return Cookies.remove(key);
		window.sessionStorage.removeItem(Local.setKey(key));
	},
	// 移除全部临时缓存
	clear() {
		Cookies.remove('token');
		window.sessionStorage.clear();
	},
};
四、特殊处理 - token 的管理

在 Session 模块中,特别处理了 token 的存储和获取。由于 token 通常需要跨多个页面共享,并且可能涉及到安全性问题(如HTTPS),所以选择将其存储在 Cookies 中,而不是 sessionStorage 或 localStorage。这样不仅可以保证 token 在不同页面之间的传递,还能利用 js-cookie 提供的安全特性,如设置 HttpOnly 和 Secure 标志。

相关推荐
吃我一窝jio6 分钟前
Java Bug复盘与性能优化实战
java·开发语言·笔记
tryCbest7 分钟前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai27331 分钟前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
bai2731 小时前
同一个 1.005,toFixed 给 1.00、Math.round 给 1、Intl 给 1.01:999 个三分位小数的实测
javascript·后端
爱编程的171 小时前
一篇讲透 JS 对象:数据类型、原型链与包装类
javascript
Evand J1 小时前
【MATLAB例程】基于APF的多无人机动态路径规划与避障仿真。避碰及安全性能分析。附完整代码的下载链接
开发语言·matlab·无人机
鲸渔2 小时前
【AI Agent系列课程13-Python 基础13】JSON 读写:结构化数据交换基础
开发语言·python·json·ai编程
Flynn Liang3 小时前
多智能体协同不再复杂:Redis Stream 消费者组、幂等与故障恢复
数据库·人工智能·redis·缓存·ai agent·智能体
Highcharts.js7 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图
武昌库里写JAVA11 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai