# localStorage 如何设置过期时间

URL: https://caijiao.org/how-to/javascript/localstorage-expire
Source: docs/how-to/javascript/localstorage-expire.md
Description: localStorage 如何设置过期时间：把 value 和 expiresAt 一起存，读取时判断过期并删除。 示例可直接复制到浏览器或项目代码中，并附相关教程、工具入口。

## 快速答案

把 value 和 expiresAt 一起存，读取时判断过期并删除。

```js
localStorage.setItem('cache', JSON.stringify({ value: data, expiresAt: Date.now() + 3600_000 }));
const item = JSON.parse(localStorage.getItem('cache') ?? 'null');
if (item && item.expiresAt > Date.now()) console.log(item.value);
```

## 使用要点

- 确认代码运行在浏览器环境；如果服务端渲染会执行同一段代码，要把读取逻辑放到客户端生命周期里。
- 处理 URL、Cookie 或存储值时，先约定编码、过期时间和缺省值。

## 相关内容

- [JavaScript / TypeScript 问题](/how-to/javascript/)
- [JavaScript 教程](/javascript/)
- [TypeScript 教程](/ts/)
- [JSON Formatter](/tool/json-formatter)
- [JSON Validator](/tool/json-validator)