现代浏览器已全面废弃Application Cache(AppCache),应改用Service Worker + Cache API实现可控离线缓存;需通过HTTPS注册sw.js,显式声明缓存资源,避免依赖过时的manifest机制。

HTML离线缓存现在基本不用了
现代浏览器已全面废弃 Application Cache(AppCache),Chrome 95+、Firefox 85+、Safari 16.4+ 均已移除支持。你看到的“可缓存页面列表勾选”这类操作,大概率来自过时教程或旧版开发工具界面——它不再生效,也不该再被配置。
为什么 AppCache 被弃用
它存在设计缺陷,导致行为不可预测:
-
manifest文件哪怕只改一个空格,整个缓存都会强制重载,无法增量更新 - 离线时若主 HTML 文件未被显式列入
CACHE段,页面直接白屏(连 fallback 都不触发) - 缓存更新时机由浏览器控制,开发者无法监听或干预,
updateready事件常不触发 - HTTPS 环境下对非同源资源(如 CDN 图片)缓存失败,且无明确报错
替代方案:用 Service Worker + Cache API
这是当前唯一标准、可控、可调试的离线方案。关键点不是“勾选列表”,而是写一段 JS 控制缓存逻辑:
在 sw.js 中定义缓存策略:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
self.addEventListener('install', e => {
e.waitUntil(
caches.open('v1').then(cache =>
cache.addAll([
'/',
'/index.html',
'/styles.css',
'/app.js'
])
)
);
});
self.addEventListener('fetch', e => {
e.respondWith(
caches.match(e.request).then(r => r || fetch(e.request))
);
});
注意几个实操细节:
- 必须通过 HTTPS(或
localhost)注册,navigator.serviceWorker.register('sw.js')才会成功 -
caches.open()的名字要带版本号(如v1),升级时改名 +self.skipWaiting()才能平滑切换 - 不能缓存带动态参数的 URL(如
/api/data?id=123),需在fetch事件中手动 strip 查询参数或跳过缓存 - 浏览器 DevTools → Application → Cache Storage 可查看和清空实际缓存内容,比“勾选列表”直观可靠
如果旧项目还在用 manifest,赶紧迁移
检查 HTML 是否含 manifest="app.manifest" 属性,以及是否存在 app.manifest 文件。只要存在,现代浏览器会静默忽略它,但可能引发混淆——比如开发者以为资源已缓存,实际每次都是网络请求。
迁移时最易漏掉的是:Service Worker 不会自动缓存 或 <script></script> 标签里的资源,必须显式列在 cache.addAll() 或 fetch 逻辑里。没列进去的,离线时照样 404。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










