跳转到主内容
websoft网络软件专家 - 深耕网络技术,打造实用软件!

HTML怎么做SW缓存策略_HTML Service Worker缓存策略方法【最全】

Service Worker离线缓存必须分install、fetch、activate三阶段协同控制:install预缓存资源,fetch按destination分流响应,activate清理旧缓存并claim接管;任一环节缺失即导致白屏或加载失败。 Service Worker 缓存策略不是“配个参数就生效”,而是必须分阶段控制:安装时预缓存哪些资源、请求时怎么匹配与回退、激活时如何清理旧版本——漏掉任一环节,离线就会白屏或加载失败。 sw.js 注册失败的三个典型原因 注册静默失败最常见于非安全上下文:
file://
协议、局域网 IP(如
http://192.168.1.100
)或未启用 HTTPS 的域名。只有
https://
和
http://localhost
被浏览器视为有效注册源。 检查控制台是否报错
Failed to register a ServiceWorker
且无堆栈——大概率是协议/域名不合规
navigator.serviceWorker.register()
必须在
window.addEventListener('load', ...)
中调用,不能放在 DOM 解析前或异步模块里 确保
sw.js
文件能被直接访问(比如打开
https://yoursite.com/sw.js
应返回 JS 内容,而非 404 或重定向) install 阶段缓存失败的常见陷阱
cache.addAll()
看似简单,但只要列表中任意一个 URL 返回非 2xx 状态(404、CORS 拒绝、500),整个缓存操作就中断,不会写入任何资源。 路径必须是绝对根路径,比如
'/index.html'
合法,
'./index.html'
或
'index.html'
会 404 不要包含带查询参数的 URL(如
'/app.js?v=2.1'
),不同参数会被当成不同缓存键,导致重复缓存和空间浪费 HTML 文件本身不能只缓存它自己——
index.html
里引用的
app.js
、
style.css
、
logo.png
必须全部列进
urlsToCache
字体、SVG 等资源若跨域或 MIME 不匹配,也会导致
addAll()
拒绝执行 fetch 事件中怎么区分资源类型做缓存 不能对所有请求一视同仁。HTML 页面必须能离线打开,而 API 接口通常不该返回过期数据——得按
request.destination
分流处理。 使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件 如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更 下载 立即学习 “ 前端免费学习笔记(深入) ”;
destination === 'document'
:主页面请求,必须命中缓存,否则离线白屏;建议 fallback 到内置 HTML 字符串或预存的 offline. html
destination === 'script'
或
'style'
:可走纯缓存优先,用
caches.match(event.request)
直接返回
destination === 'image'
或
'font'
:可加 try/catch,fetch 失败时跳过缓存,避免阻塞渲染
destination === 'json'
或空字符串(如
fetch('/api/data')
):适合
stale-while-revalidate
:先返回缓存,再 fetch 更新,响应头需设
Cache-Control: max-age=0, stale-while-revalidate=60
activate 阶段清理旧缓存为什么总出错 清理动作不是“删掉旧名就行”,必须避开当前正在使用的缓存,否则页面还在读 v1 缓存,你却把 v1 删了,会触发
TypeError: Request failed
。 清理逻辑必须放在
activate
事件里,不能放
install
——此时旧 SW 还在运行 用
caches.keys().then(keys => keys.filter(k => !k.includes('v2')).map(caches.delete))
这类方式,确保只删“非当前版本” 配合
self.clients.claim()
让新 SW 尽快接管,避免新旧缓存混用 注意:HTTP 缓存(
Cache-Control
)和 Cache Storage 是两套独立系统,清理
caches.delete()
不影响 disk/memory cache,反之亦然 最易被忽略的是:HTML 文件本身没有缓存生命周期控制能力,所有缓存行为完全依赖 SW 的 install/fetch/activate 三阶段协同;一旦某个阶段逻辑缺失或顺序错乱,离线体验就不可控——这不是配置问题,是状态机逻辑问题。

相关文章