如何利用 SharedWorker 构建多标签页共享的数据缓存层规避 API 重复请求

酷杰大大_4696

酷杰大大_4696

2026-04-28

260人浏览

原创

能,但必须用显式 promise 缓存 + 请求去重队列实现;sharedworker 不共享 localstorage 或全局变量,需以 requestkey 为键的 map 管理 active promise,并配合 abortcontroller、超时控制、port.close() 清理及业务字段(如 force)控制缓存策略。

如何利用 sharedworker 构建多标签页共享的数据缓存层规避 api 重复请求

能,但必须绕过 SharedWorker 默认无状态、无缓存的陷阱,用显式 Promise 缓存 + 请求去重队列实现。直接在 SharedWorker 里 localStorage.setItem() 或存全局对象是无效的——它不共享内存,也不持久化。

SharedWorker 里不能直接用 localStorage 或全局变量做缓存

SharedWorker 确实运行在独立上下文,但它和页面一样,localStorage 是按源隔离的,每个页面连的还是自己的 storage;而全局变量(比如 cache = new Map())看似可行,实际会因 Worker 被浏览器回收(如所有页面关闭后又重开)而丢失,且无法跨重启保留。

更关键的是:多个页面并发请求同一 URL 时,若没加锁,Worker 会并行发起多次 fetch,完全起不到去重作用。

  • 不要写 cache.set(url, response) 后就直接 resolve —— 下一个请求进来时 cache 还没写完,照样会再发一次
  • 不要在 onconnect 外层声明 const pending = new Map() —— 它不会跨 Worker 实例存活,且无法被新连接的 port 访问到一致状态
  • 浏览器可能随时终止空闲 SharedWorker,所以不能依赖其内存长期缓存;需配合 IndexedDB 做落地,但首次冷启仍要防并发

用 Promise 池 + Map 键控实现请求级去重

核心思路是:对相同请求参数(如 { url: '/api/user', method: 'GET' }),只允许一次 fetch 执行,后续请求都 await 同一个 Promise 实例。这需要把 Promise 和 resolve/reject 存进一个共享 Map,并确保 key 足够唯一(推荐 JSON.stringify 规范化参数)。

Hitems
Hitems

一款面向电商视觉创作的AI设计工具,帮助用户利用生成式技术制作产品展示图和营销视觉素材。

下载
const activeRequests = new Map(); // key: requestKey, value: { promise, resolve, reject }

function getRequestKey(req) {
  return JSON.stringify({
    url: req.url,
    method: req.method || 'GET',
    body: req.body ? JSON.stringify(req.body) : undefined
  });
}

self.onconnect = (e) => {
  const port = e.ports[0];
  port.start();

  port.onmessage = (e) => {
    const { id, type, request } = e.data;
    if (type === 'fetch') {
      const key = getRequestKey(request);
      let entry = activeRequests.get(key);

      if (!entry) {
        const controller = new AbortController();
        const timeout = setTimeout(() => controller.abort(), 10000);

        entry = {
          promise: fetch(request.url, { ...request, signal: controller.signal })
            .then(r => r.json())
            .catch(err => { throw err.name === 'AbortError' ? new Error('Request timeout') : err; })
            .finally(() => {
              clearTimeout(timeout);
              activeRequests.delete(key);
            }),
          resolve: null,
          reject: null
        };

        activeRequests.set(key, entry);
      }

      // 所有同 key 请求都复用这个 promise
      entry.promise
        .then(data => port.postMessage({ id, result: data }))
        .catch(err => port.postMessage({ id, error: err.message }));
    }
  };
};
  • key 必须包含 method 和规范化 body,否则 POST /user 和 GET /user 会被当成同一请求
  • 务必用 AbortController 配合超时,防止某个请求卡死拖垮整个队列
  • finally 中清理 activeRequests,否则内存泄漏;但注意不要在 catch 后提前删,得等 promise 真正 settle

页面端调用时必须传唯一 id 并正确处理 port.close()

SharedWorker 不自动感知页面关闭,如果页面刷新或崩溃,它持有的 Promise 会一直 pending,后续请求被 block。必须由页面主动通知“我走了”。

页面侧代码关键点:

const worker = new SharedWorker('/sw-cache.js');
const port = worker.port;

// 发送带 id 的请求
let reqId = 0;
function fetchShared(url, options = {}) {
  const id = ++reqId;
  port.postMessage({ id, type: 'fetch', request: { url, ...options } });

  return new Promise((resolve, reject) => {
    const onMessage = (e) => {
      if (e.data.id === id) {
        if (e.data.result) resolve(e.data.result);
        else reject(new Error(e.data.error));
        port.removeEventListener('message', onMessage);
      }
    };
    port.addEventListener('message', onMessage);
  });
}

// 页面卸载前关闭 port,触发 Worker 的 onclose
window.addEventListener('beforeunload', () => {
  port.close();
});
  • 每次调用 fetchShared() 必须生成新 id,否则多个请求会互相覆盖响应
  • port.close() 必须在 beforeunload 里调,不能只靠 visibilitychange —— 用户直接关标签页时后者不触发
  • Worker 端需监听 port.onclose 并手动清理对应 pending 请求(如果有的话),但 Promise 池本身靠 finally 清理更可靠

缓存失效与强制刷新需要额外协议字段

纯去重不够,业务常需要“跳过缓存”或“强制更新”。不能靠时间戳拼 URL(那就不去重了),应在请求体里加控制字段:

  • 加 force: true 字段 → Worker 不查 Promise 池,直接发起新 fetch 并覆盖旧 entry
  • 加 staleWhileRevalidate: true → 先返回缓存(如果有),再后台拉新数据并广播更新
  • 服务端响应带 Cache-Control: no-store 时,Worker 应跳过缓存逻辑,避免污染

真正难的不是写代码,而是想清楚:哪些请求该去重、哪些该强制走网络、哪些该降级返回 stale 数据——这些策略没法交给 SharedWorker 自动判断,得由业务层通过字段明确表达。否则,你写的“缓存层”可能变成“阻塞层”。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.06.20

5066

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

4984

6

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

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

2023.09.01

980

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1896

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3565

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4633

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3040

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

968

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
誉天教育RHCE视频教程
誉天教育RHCE视频教程

共9课时 | 1.8万人学习

尚观Linux RHCE视频教程(二)
尚观Linux RHCE视频教程(二)

共34课时 | 7万人学习

尚观RHCE视频教程(一)
尚观RHCE视频教程(一)

共28课时 | 5.9万人学习