如何给localStorage设置一个过期时间？

最新推荐文章于 2025-04-04 17:30:15 发布

置顶苏南South

最新推荐文章于 2025-04-04 17:30:15 发布

阅读量6.3w

点赞数 15

分类专栏：前端 javascript reactjs 文章标签： localstorage 小程序前端数据缓存 cookie

本文链接：https://blog.csdn.net/weixin_43254766/article/details/83618630

版权

前端同时被 3 个专栏收录

30 篇文章

订阅专栏

javascript

22 篇文章

订阅专栏

reactjs

8 篇文章

订阅专栏

本文详细介绍了如何为localStorage设置过期时间。通过重写set、get和remove方法，实现数据存储时附带过期时间戳，并在获取时检查是否过期。优化点包括初始化删除已过期数据，确保数据的有效性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文由@IT·平头哥联盟-首席填坑官∙苏南分享，公众号：honeyBadger8

作者：首席填坑官∙苏南
公众号：honeyBadger8，本文原创，著作权归作者所有，转载请注明原链接及出处。

引言

　　这个话题其实在上次分享<小程序填坑记里讲过了>已经讲过（大佬可绕过哦～），但后来群里/评论都有些同学，提到了一些疑问，问能否单独整理一篇更为详细的分享，讲解一下细节和完善提到的不足，如是有了下文?。 —— 「 用心分享做有温度的攻城狮，我是首席填坑官——苏南」

JS中文网 - 前端进阶资源教程 www.javascriptc.com
一个致力于帮助开发者用代码改变世界为使命的平台，每天都可以在这里找到技术世界的头条内容

思考点

　　从我们接触前端起，第一个熟悉的存储相关的Cookie或者来分析我们生活中密切相关的淘宝、物流、闹钟等事物来说起吧，

Cookie从你设置的时候，就会给个时间，不设置默认会话结束就过期；
淘宝购物从你下单付款起，就会给这件货物设置一个收货期限时间，过了这个时间自动认为你收货（即订单结束）；
闹钟你设置的提醒时间，其实也就是它的过期时间；
再比如与您每天切身相关的产品需求，过完需求，你给出的上线时间，也就是这个需求的过期时间；
再通俗点讲，您今年的生日过完到明年生日之间也是相当于设置了有效期时间；

以上种种，我们能得出一个结论任何一件事、一个行为动作，都有一个时间、一个节点，甚至我们可以黑localStorage，就是一个完善的API，为什么不能给一个设置过期的机制，因为sessionStorage、Cookie并不能满足我们实际的需求。

实现思路

抱歉，黑localStorage不完善，有点夸张了，综合上述的总结，问题就简单了，给localStorage一个过期时间，一切就都so easy ？到底是不是，来看看具体的实现吧：

简单回顾

//示例一：
localStorage.setItem('test',1234567);
let test = localStorage.getItem('test');
console.log(typeof test, test); 

//示例二：
localStorage['name'] = '苏南';
console.log(localStorage['name']);
/*
输出:
"1234567" ,'苏南',
这里要注意，1234567 存进去时是number 取出来就成string了
*/

重写 set(存入) 方法：

首先有三个参数 key、value、expired ，分别对应键、值、过期时间，
过期时间的单位可以自由发挥，小时、分钟、天都可以，
注意点：存储的值可能是数组/对象，不能直接存储，需要转换 JSON.stringify，
这个时间如何设置呢？在这个值存入的时候在键(key)的基础上扩展一个字段，如：key+‘expires’，而它的值为当前时间戳 + expired过期时间
具体来看一下代码 ：


set(key, value, expired) {
	/*
	* set 存储方法
	* @ param {String} 	key 键
	* @ param {String} 	value 值，
	* @ param {String} 	expired 过期时间，以分钟为单位，非必须
	* @ 由@IT·平头哥联盟-首席填坑官∙苏南 分享
	*/
	let source = this.source;
	source[key] = JSON.stringify(value);
	if (expired){
		source[`${key}__expires__`] = Date.now() + 1000*60*expired
	};
	return value;
}

重写 get(获取) 方法：

获取数据时，先判断之前存储的时间有效期，与当前的时间进行对比；
但存储时expired为非必须参数，所以默认为当前时间+1，即长期有效；
如果存储时有设置过期时间，且在获取的时候发现已经小于当前时间戳，则执行删除操作，并返回空值；
注意点：存储的值可能是数组/对象，取出后不能直接返回，需要转换 JSON.parse，
具体来看一下代码 ：

get(key) {
	/*
	* get 获取方法
	* @ param {String} 	key 键
	* @ param {String} 	expired 存储时为非必须字段，所以有可能取不到，默认为 Date.now+1
	* @ 由@IT·平头哥联盟-首席填坑官∙苏南 分享
	*/
	const source = this.source,
	expired = source[`${key}__expires__`]||Date.now+1;
	const now = Date.now();

	if ( now >= expired ) {
		this.remove(key);
		return;
	}
	const value = source[key] ? JSON.parse(source[key]) : source[key];
	return value;
}

重写 remove(删除) 方法：

删除操作就简单了，；
阿里云产品限时优惠


remove(key) {
	const data = this.source,
		value = data[key];
	delete data[key];
	delete data[`${key}__expires__`];
	return value;
}

优化点：

记得上次有个同学，是这么评论的：「删除缓存能放到constructor里面执行么，放到get里面不取就一直在那是不是不太好？」；
所以本次优化做一个初始化删除操作，清除已经过期的数据;
为什么不用for in而是 for ? for in循环遍历对象的属性时，原型链上的所有属性都将被访问，解决方案：使用hasOwnProperty方法过滤或Object.keys会返回自身可枚举属性组成的数组；


class storage {

	constructor(props) {
		this.props = props || {}
		this.source = this.props.source || window.localStorage
		this.initRun();
	}
	initRun(){
		/*
		* set 存储方法
		* @ param {String} 	key 键
		* @ param {String} 	value 值，存储的值可能是数组/对象，不能直接存储，需要转换 JSON.stringify
		* @ param {String} 	expired 过期时间，以分钟为单位
		* @ 由@IT·平头哥联盟-首席填坑官∙苏南 分享
		*/
		const reg = new RegExp("__expires__");
		let data = this.source;
		let list = Object.keys(data);
		if(list.length > 0){
			list.map((key,v)=>{
				if( !reg.test(key )){
					let now = Date.now();
					let expires = data[`${key}__expires__`]||Date.now+1;
					if (now >= expires ) {
						this.remove(key);
					};
				};
				return key;
			});
		};
	}
}