web worker 无法直接传递 cache 实例,因为 cache 对象不是结构化克隆算法支持的类型。正确的做法是在主线程中通过 cache.keys() 获取所有缓存键名,将结果数组传递给 worker;worker 拿到键名后,使用 caches.open() 重新打开同一个命名空间并调用 cache.match() 或 cache.addall() 来读取或写入数据。

为什么 Cache 对象不能直接序列化
在 JavaScript 中,跨线程通信依赖结构化克隆算法(Structured Clone Algorithm)。该算法支持基本数据类型、数组、普通对象以及部分内置对象如 Date 和 RegExp,但明确排除了 Cache、Request 和 Response 等 Web API 对象。这些对象通常持有底层系统资源或状态,无法被安全地复制到另一个执行上下文中。如果尝试直接将 Cache 实例放入 postMessage,浏览器会抛出 DataCloneError。

try {
const cache = await caches.open('my-cache');
worker.postMessage(cache); // 这里会报错
} catch (e) {
console.error(e.name); // DataCloneError
}
因此,开发者必须改变思路:不传递“容器”本身,而是传递“容器内的内容”或“容器的访问凭证”。对于 Cache API,最直接的凭证就是缓存的名称(Name)和请求的 URL(Key)。
如何通过键名同步缓存数据
既然不能传递实例,就需要在主线程和 Worker 之间建立一种基于名称的协作机制。主线程负责管理缓存的生命周期,而 Worker 负责具体的匹配逻辑。双方都通过 caches.open(name) 获取对同一缓存空间的引用。由于 caches.open() 返回的是 Promise,且在不同线程中调用会返回不同的 Cache 对象实例,但它们指向浏览器存储中的同一个物理区域,所以操作是共享的。
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。

// 主线程
const worker = new Worker('worker.js');
const cacheName = 'v1-static';
// 获取所有缓存的 URL 键名
const keys = await caches.keys();
worker.postMessage({ type: 'INIT_KEYS', payload: keys });
// Worker 内部
self.onmessage = async (e) => {
if (e.data.type === 'INIT_KEYS') {
const { payload } = e.data;
const cache = await self.caches.open('v1-static');
// 遍历键名进行匹配
for (const key of payload) {
const response = await cache.match(key);
if (response) {
console.log(`Found cached resource: ${key}`);
}
}
}
};
这种模式允许 Worker 在不持有原始引用的情况下,独立查询和操作缓存。如果需要向缓存写入数据,Worker 同样可以使用 cache.add() 或 cache.put(),这些数据会立即对主线程可见,反之亦然。关键在于确保双方使用完全一致的 cacheName 字符串。
处理复杂请求对象的替代方案
在实际应用中,除了缓存键名,有时还需要传递具体的 Request 对象信息。与 Cache 类似,Request 和 Response 也不能直接通过 postMessage 传递。如果 Worker 需要知道某个特定资源的详细配置(如 Headers、Method),主线程需要将 Request 序列化为纯数据对象(Plain Object)再发送。Worker 收到数据后,可以使用新的 Request 构造函数重建请求对象,然后用于 fetch 或 cache.match()。
// 主线程:将 Request 转为 JSON 兼容格式
const req = new Request('/api/data', { method: 'POST' });
worker.postMessage({
url: req.url,
method: req.method,
headers: Object.fromEntries(req.headers.entries())
});
// Worker:重建 Request
self.onmessage = async (e) => {
const { url, method, headers } = e.data;
const request = new Request(url, { method, headers });
const cache = await self.caches.open('api-cache');
await cache.put(request, await fetch(request));
};
这种方式虽然增加了序列化和反序列化的开销,但它是唯一能在 Worker 中精确控制缓存行为的方法。通过传递结构化的数据而非对象实例,开发者可以绕过浏览器的安全限制,实现主线程与 Worker 之间的缓存数据同步。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










