HTML5离线应用实现攻略
HTML离线应用已全面告别废弃的Application Cache,Service Worker成为唯一标准化、全平台支持的现代解决方案;它要求HTTPS或localhost环境,需严谨处理注册失败、install阶段缓存原子性、fetch事件的资源类型分级响应(如HTML离线兜底、静态资源强缓存、API请求明确报错),并主动管理缓存版本清理以防存储膨胀——掌握这些关键实践,才能真正实现稳定可靠的离线体验。

Application Cache 已被现代浏览器废弃,Chrome 95+、Firefox 85+、Safari 16.4+ 均已移除支持。直接用 manifest 属性 + .appcache 文件的方式,在当前主流浏览器中完全失效,且无法降级兼容。
如果你的目标是“让用户在断网时仍能打开网页并看到内容”,请立刻转向 Service Worker —— 它是当前唯一被 W3C 标准化、全平台支持、可精细控制的离线方案。
Service Worker 注册失败的常见原因
- 页面不是通过
https或localhost提供的:非安全上下文下navigator.serviceWorker为undefined sw.js路径错误或返回了非200状态码(比如 404 或 302 重定向)sw.js文件响应头中包含Cache-Control: no-cache或must-revalidate,导致注册被浏览器拒绝- 同一域名下已有激活中的 Service Worker,新注册脚本未触发更新(需手动 unregister 或等待下次 fetch)
检查方法:
打开 DevTools → Application → Service Workers,看是否显示 “Waiting”、“Active” 或报错信息;若为空白且无提示,大概率是注册脚本根本没执行。
install 阶段缓存资源不生效
cache.addAll() 是原子操作:只要列表中任一资源 fetch 失败(如路径 404、跨域、MIME 类型不匹配),整个缓存就会中止,waitUntil 报错,Worker 卡在 installing 状态。
常见踩坑点:
cache.addAll(['/', '/index.html'])中/实际返回的是服务端渲染页面(含动态 HTML),但该响应头带Cache-Control: no-store→ 缓存失败- 引用了相对路径资源(如
./style.css),而sw.js在子目录(如/js/sw.js)下注册 → 路径解析为/js/./style.css,404 - 清单里写了
/images/logo.png,但实际文件名是logo@2x.png或大小写不符(Linux 服务器区分大小写)
建议做法:
- 所有预缓存路径统一用绝对路径(以
/开头) - 在
install前加日志:console.log('installing with:', urlsToCache) - 用
fetch(url).then(r => r.ok ? r : Promise.reject(r))手动校验每个 URL
fetch 事件里离线 fallback 写法容易出错
只写 caches.match(event.request).then(r => r || fetch(event.request)) 是典型“半离线”写法:它对 HTML 请求有效,但对 API 接口请求会暴露错误(比如返回空 JSON 或 504 页面)。
更稳妥的模式是分类型处理:
- HTML 页面请求 → 优先返回缓存,无则 fallback 到
/offline.html - CSS/JS/图片等静态资源 → 必须命中缓存,否则报错(说明构建或部署漏文件)
- API 请求(如
/api/user)→ 直接返回Response.error()或自定义 JSON 错误体,避免前端解析异常
示例片段(简化版):
self.addEventListener('fetch', event => {
const { request } = event;
const url = new URL(request.url);
if (request.destination === 'document') {
event.respondWith(
caches.match(request).then(r => r || caches.match('/offline.html'))
);
} else if (url.pathname.startsWith('/api/')) {
event.respondWith(Response.error());
} else {
event.respondWith(
caches.match(request).then(r => r || fetch(request))
);
}
});
Service Worker 的缓存不是“设好就完事”的黑盒,它依赖你对每个资源路径、响应头、网络状态和用户预期的明确判断。最容易被忽略的是:缓存版本升级后,旧缓存不会自动清理,长期运行可能占满用户设备存储,尤其在 PWA 场景下。上线前务必测试 caches.delete() 清理逻辑,并监控 caches.keys() 返回的缓存列表。
今天关于《HTML5离线应用实现攻略》的内容就介绍到这里了,是不是学起来一目了然!想要了解更多关于的内容请关注golang学习网公众号!
Chrome调试器设置条件断点定位循环错误
- 上一篇
- Chrome调试器设置条件断点定位循环错误
- 下一篇
- Win11降级Win10教程全攻略
-
- 文章 · 前端 | 2小时前 | 前端 · javascript · JavaScript DOM遍历 NodeIterator referenceNode
- JavaScript NodeIterator.referenceNode 怎样读取迭代器当前参照的节点
- 326浏览 收藏
-
- 文章 · 前端 | 2小时前 | 前端 · JavaScript Event defaultPrevented
- JavaScript Event.defaultPrevented 怎样判断事件默认行为是否已经被取消
- 391浏览 收藏
-
- 文章 · 前端 | 3小时前 | 前端 · javascript · 浏览器API · JavaScript Selection focusNode focusOffset DOM Node 文本选择
- JavaScript Selection.focusNode 怎样取得用户当前延伸选择的端点节点
- 492浏览 收藏
-
- 文章 · 前端 | 4小时前 | 前端 · javascript · JavaScript CSSOM CSSStyleSheet CSSRule parentStyleSheet cssRules parentRule
- JavaScript CSSRule.parentStyleSheet 怎样取得一条规则所属的样式表
- 323浏览 收藏
-
- 文章 · 前端 | 6小时前 | javascript · JavaScript 滚动条 Element.clientLeft 左边框
- JavaScript Element.clientLeft 怎样理解左边框宽度与滚动条占位
- 290浏览 收藏
-
- 文章 · 前端 | 7小时前 | 前端 · javascript · JavaScript Shadow DOM Event.composed
- JavaScript Event.composed 怎样判断事件能否跨越影子根边界
- 149浏览 收藏
-
- 文章 · 前端 | 7小时前 | javascript · JavaScript dom Selection anchorOffset
- JavaScript Selection.anchorOffset 怎样理解选择起点在文本与元素中的偏移
- 496浏览 收藏
-
- 文章 · 前端 | 8小时前 | javascript · JavaScript CSSStyleSheet ownerRule CSSImportRule
- JavaScript StyleSheet.ownerRule 怎样取得导入样式表对应的规则对象
- 357浏览 收藏
-
- 文章 · 前端 | 9小时前 | html · 前端 · javascript · 表单 · JavaScript id for label 表单控件 Control HTMLLabelElement
- JavaScript HTMLLabelElement.control 怎样取得标签实际关联的表单控件
- 338浏览 收藏
-
- 文章 · 前端 | 10小时前 | 前端 · javascript · JavaScript DOM遍历 TreeWalker NodeFilter whatToShow
- JavaScript TreeWalker.whatToShow 怎样区分节点类型掩码与自定义过滤器
- 223浏览 收藏
-
- 文章 · 前端 | 10小时前 | 前端 · range · javascript · JavaScript dom range 富文本 isPointInRange 节点偏移
- JavaScript Range.isPointInRange 怎样判断指定节点偏移是否落在范围内
- 145浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1099次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1095次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1265次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1204次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1051次使用
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 智能体安全引领产业升级——国内AI安全产品市场深度分析
- 2026-08-21 501浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览

