Service Worker是运行在主线程外的可编程网络代理,需HTTPS注册、显式缓存资源、拦截fetch事件并提供fallback;不可用localStorage/DOM API,须用cacheStorage、IndexedDB或postMessage;fetch事件必须respondWith,新版本需skipWaiting/clients.claim调试。

Service Worker 本质是一个可编程的网络代理,它运行在浏览器主线程之外,能拦截、修改甚至伪造网络请求。要创建离线应用,关键不是“注册就能离线”,而是必须显式缓存资源 + 拦截 fetch 事件 + 提供 fallback 策略。
注册 Service Worker 必须用 HTTPS(本地 localhost 除外)
浏览器只允许在安全上下文中注册 ServiceWorker。开发时可用 localhost,但部署到真实域名必须启用 HTTPS,否则 navigator.serviceWorker.register() 会静默失败或直接抛 SecurityError。
常见错误现象:Failed to register a ServiceWorker: ServiceWorker script does not exist 或控制台无报错但 registration 为 undefined —— 先检查协议是否为 https:// 或 http://localhost。
- 注册代码必须放在
window.addEventListener('load', ...)或页面 DOM 就绪后执行,不能在模块顶层同步调用 -
register()的路径是相对于站点根目录的,比如/sw.js,不是./sw.js - 每次访问页面都会触发注册,但浏览器只在
sw.js文件内容字节变化时才重新安装新版本
install 和 fetch 事件里不能用 localStorage 或 DOM API
ServiceWorker 是一个独立的 worker 线程,没有 window、document、localStorage 等浏览器环境对象。试图读写 localStorage 会直接报 ReferenceError;操作 document.body 会报 undefined is not an object。
立即学习“Java免费学习笔记(深入)”;
替代方案只有三种:
- 用
cacheStorage缓存静态资源(HTML/CSS/JS/图片) - 用
IndexedDB存结构化数据(需在install或activate阶段初始化) - 通过
postMessage()和主页面通信,让页面端处理 DOM 或 storage 逻辑
fetch 事件中必须显式 return response,否则请求失败
只要注册了 Service Worker,所有同源请求(包括 fetch、XMLHttpRequest、、)都会经过 fetch 事件。但默认行为不是“自动走缓存”,而是“放行到网络”——你必须自己 event.respondWith(...),否则请求会卡住或返回空响应。
每个应用程序都要使用数据,Android应用程序也不例外,Android使用开源的、与操作系统无关的SQL数据库--SQLite,本文介绍的就是如何为你的Android应用程序创建和操作SQLite数据库。 数据库支持每个应用程序无论大小的生命线,除非你的应用程序只处理简单的数据,那么就需要一个数据库系统存储你的结构化数据,Android使用SQLite数据库,它是一个开源的、支持多操作系统的SQL数据库,在许多领域广泛使用,如Mozilla FireFox就是使用SQLite来存储配置数据的,iPhon
典型离线兜底写法:
self.addEventListener('fetch', event => {
event.respondWith(
caches.match(event.request)
.then(cached => cached || fetch(event.request))
.catch(() => caches.match('/offline.html'))
);
});
注意点:
-
caches.match()不匹配带动态查询参数的 URL(如/api/data?id=123),需手动 normalize 或改用cache.addAll()预缓存固定路径 - 不要在
fetch事件里直接return fetch(...)而不包在respondWith()中,这会导致未捕获异常中断请求流 - 对非 GET 请求(如 POST),通常不应缓存,应直连服务器,否则可能造成状态不一致
调试时别忘了 skipWaiting 和 clients.claim
新版本 Service Worker 默认不会立即激活:它会等所有旧 tab 关闭后才进入 waiting → active 状态。这意味着你改了 sw.js,但页面仍用老逻辑,容易误判缓存是否生效。
开发阶段建议在 install 事件中加强制激活:
self.addEventListener('install', event => {
event.waitUntil(self.skipWaiting());
});
self.addEventListener('activate', event => {
event.waitUntil(self.clients.claim());
});
但上线前应移除 skipWaiting(),否则可能造成新旧缓存策略冲突(比如新版删了某个缓存 key,但旧 tab 还在读它)。
真正难的不是注册或缓存,而是设计缓存生命周期:哪些资源该长期缓存?API 响应要不要缓存?离线时表单提交怎么暂存?这些没想清楚,光跑通 sw.js 文件加载只是第一步。









