web worker 无法直接传递 cachestorage 实例,因为它是浏览器主线程的专有 api。正确的做法是在 worker 中通过 self.caches 访问同源的缓存存储,或者在主线程执行操作后通过 postmessage 将结果(如键名或状态)传回 worker。

Worker 内部如何调用 caches API
在 Web Worker 脚本中,可以直接使用全局对象 self 来访问 caches 属性。这与在主线程使用 window.caches 的效果完全一致,允许 Worker 独立管理缓存数据,而无需依赖主线程的上下文。

const worker = new Worker('worker.js');
// worker.js
self.addEventListener('message', async (e) => {
const { action, url } = e.data;
if (action === 'open') {
// 直接在 Worker 中打开缓存
const cache = await self.caches.open('my-cache-v1');
await cache.add(url);
self.postMessage({ status: 'cached' });
}
});上述代码展示了 Worker 接收消息后,直接使用 self.caches.open() 打开一个命名缓存,并添加指定 URL。这种设计让缓存逻辑完全封装在 Worker 中,主线程只需发送指令即可。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
主线程与 Worker 的数据交互模式
当需要主线程参与缓存决策时,通常采用“主线程查询、Worker 执行”或“Worker 请求、主线程响应”的模式。由于 CacheStorage 对象不可序列化,双方只能通过传递字符串(如缓存名称或 URL)进行通信。

// main.js
const worker = new Worker('worker.js');
async function init() {
// 主线程检查缓存是否存在
const cache = await window.caches.open('my-cache-v1');
const keys = await cache.keys();
// 将键名列表发送给 Worker
worker.postMessage({ type: 'update-keys', keys: keys.map(k => k.url) });
}
// worker.js
self.addEventListener('message', (e) => {
if (e.data.type === 'update-keys') {
console.log('Worker received keys:', e.data.keys);
// Worker 根据收到的键名决定后续行为
}
});在这个模式中,主线程负责获取缓存的具体元数据(如 keys() 返回的对象数组),并将其序列化为简单的 URL 字符串数组发送给 Worker。Worker 接收到这些字符串后,可以基于此做出本地决策,例如决定是否发起网络请求。这种方式避免了跨线程传递复杂对象带来的性能损耗和兼容性问题。
处理 CacheStorage 操作中的异常与状态
在实际开发中,CacheStorage 的操作可能因磁盘空间不足、权限问题或浏览器限制而失败。Worker 必须妥善处理这些异步错误,并通过
postMessage</sup> 将错误状态反馈给主线程,以便 UI 层做出相应调整。</p><pre class="brush:php;toolbar:false;">// worker.js
self.addEventListener('message', async (e) => {
try {
const cache = await self.caches.open('critical-cache');
await cache.addAll(e.data.urls);
self.postMessage({ type: 'success', count: e.data.urls.length });
} catch (error) {
// 捕获具体错误并传递类型信息
self.postMessage({
type: 'error',
message: error.name,
details: error.message
});
}
});
当 addAll 方法因超出配额抛出 <code>QuotaExceededError 时,Worker 会捕获该异常,并将错误名称和详细信息打包成对象发送回主线程。主线程监听 message 事件后,可以根据 error.name 判断具体故障原因,从而提示用户清理空间或降级服务。这种明确的错误传播机制确保了缓存操作的健壮性。

















