JavaScript中怎么用Promise实现一个前端数据本地缓存的防抖拦截器

云明大大_4267

云明大大_4267

2026-07-26

1013人浏览

原创

通过 promise 实现前端数据本地缓存的防抖拦截器,核心是避免重复请求、复用未过期缓存、同一请求只发一次:1. 用请求方法+url+参数生成唯一 key 并封装 localstorage 读写(含过期校验);2. 用 map 缓存 pending promise,相同 key 复用而非重发;3. 请求成功后写入带时间戳的缓存,reject 或 resolve 后均清理 pending。

javascript中怎么用promise实现一个前端数据本地缓存的防抖拦截器

用 Promise 实现前端数据本地缓存的防抖拦截器,核心是:**避免重复请求 + 缓存未过期数据 + 同一请求只发一次**。关键不在“防抖”本身(那是节流/防抖函数的事),而在于对相同请求参数做并发归并 + 缓存时效控制。

1. 缓存键生成与本地存储封装

缓存需唯一标识每个请求,通常用请求方法 + URL + 序列化参数生成 key;本地存储建议封装读写逻辑,自动处理 JSON 序列化和过期判断:

  • 使用 localStorage 或 indexedDB(大容量场景);小项目用 localStorage 即可
  • 缓存值结构包含 data、timestamp、expiresIn(毫秒)
  • 读取时先校验是否过期,过期则自动清理并返回 null

2. 请求归并:用 Map 缓存 pending 的 Promise

对同一 key 的多次调用,不发起新请求,而是复用正在执行的 Promise —— 这是“防抖拦截”的本质(更准确说是“请求去重”):

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载
  • 维护一个 Map>,key 是请求标识
  • 首次调用时创建 Promise 并存入 Map;后续调用直接返回该 Promise
  • Promise resolve 后,从 Map 中删除(或保留一段时间供快速重试)
  • 注意:reject 也要清理,否则错误状态会一直卡住后续请求

3. 缓存策略与请求触发逻辑

完整流程是:查缓存 → 未命中或已过期 → 归并请求 → 请求成功 → 写缓存 → 返回结果:

  • 优先读缓存,命中且未过期就直接 resolve 缓存数据
  • 未命中时,才进入 pending Map 归并逻辑
  • 实际请求由 fetch / axios 等发起,成功后写入缓存(含时间戳)
  • 可选:支持强制刷新(如加 { force: true } 参数跳过缓存)

4. 使用示例:封装成通用 fetchWithCache 函数

下面是一个轻量实现(基于 fetch + localStorage):

const pending = new Map();
const CACHE_TTL = 5 * 60 * 1000; // 5 分钟
<p>function getCacheKey(url, params) {
return <code>${url}?${new URLSearchParams(params).toString()}</code>;
}</p><p>function readCache(key) {
const item = localStorage.getItem(key);
if (!item) return null;
const { data, timestamp, expiresIn } = JSON.parse(item);
if (Date.now() - timestamp > expiresIn) {
localStorage.removeItem(key);
return null;
}
return data;
}</p><p>function writeCache(key, data) {
localStorage.setItem(key, JSON.stringify({
data,
timestamp: Date.now(),
expiresIn: CACHE_TTL
}));
}</p><p>async function fetchWithCache(url, options = {}) {
const { method = 'GET', body, cache = true, force = false } = options;
const params = method === 'GET' ? Object.fromEntries(new URL(url).searchParams) : {};
const key = getCacheKey(url, params);</p><p>if (cache && !force) {
const cached = readCache(key);
if (cached !== null) return cached;
}</p><p>if (pending.has(key)) {
return pending.get(key);
}</p><p>const promise = (async () => {
try {
const res = await fetch(url, { method, body });
if (!res.ok) throw new Error(res.statusText);
const data = await res.json();
if (cache) writeCache(key, data);
return data;
} finally {
pending.delete(key);
}
})();</p><p>pending.set(key, promise);
return promise;
}
</p>

调用:fetchWithCache('/api/user', { method: 'GET' }),相同 URL 参数的并发调用会自动合并。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2563

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5523

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6550

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6198

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

883

5

js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5046

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1249

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4964

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

960

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.2万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习