0

0

JavaScriptServiceWorker怎样实现离线应用【教程】

狼影

狼影

发布时间:2026-01-22 12:40:48

|

892人浏览过

|

来源于php中文网

原创

service worker 注册失败主因是路径或作用域错误:路径须为根目录相对路径(如"/sw.js"),scope需显式设为"/"才能覆盖全站;必须https(localhost除外),且页面加载完成后注册。

javascriptserviceworker怎样实现离线应用【教程】

Service Worker 注册失败的常见原因

注册不成功,八成是路径或作用域问题。navigator.serviceWorker.register() 的第一个参数必须是相对于站点根目录的路径(比如 "/sw.js"),不能写成 "./sw.js""sw.js"。另外,Service Worker 只能控制其脚本所在路径及子路径下的页面——如果 sw.js 放在 /assets/sw.js,它默认只能接管 /assets/ 下的页面,得用 scope 选项显式设为 "/" 才能覆盖整个站点。

还要确认当前环境:必须是 HTTPS(本地 localhost 除外),且页面已完全加载后再调用注册(避免在 document.write 或未就绪的 DOM 中执行)。

  • 检查浏览器控制台是否有 Failed to register a ServiceWorker 错误,点开看具体提示
  • 打开 Application → Service Workers 面板,确认状态是否为 “activated” 而非 “waiting” 或 “red”
  • 首次注册后刷新页面不会立即生效,需关掉所有标签页再重开,或勾选 “Update on reload” 强制更新

缓存静态资源时如何区分 runtime 和 install 时机

install 事件适合预缓存确定不变的资源(如 HTML、CSS、JS、图标),用 caches.open().addAll() 一次性写入;fetch 事件则处理运行时请求(比如 API 响应、用户上传的图片),需要手动 event.respondWith() 并决定是否缓存、缓存多久。

混用这两类逻辑容易导致离线时拿不到动态内容,或者缓存爆炸。例如把用户头像 URL 直接塞进 install 列表,下次头像更新就永远看不到新图。

立即学习Java免费学习笔记(深入)”;

Android应用程序消息处理机制分析 中文WORD版
Android应用程序消息处理机制分析 中文WORD版

Android应用程序是通过消息来驱动的,系统为每一个应用程序维护一个消息队例,应用程序的主线程不断地从这个消息队例中获取消息(Looper),然后对这些消息进行处理(Handler),这样就实现了通过消息来驱动应用程序的执行,本文将详细分析Android应用程序的消息处理机制。有需要的朋友可以下载看看

下载
  • 预缓存清单建议用构建工具生成(如 Workbox 的 generateSW),避免手写漏项
  • API 请求别盲目缓存,加判断:只缓存 GET 请求,忽略带 Authorizationcookie 的敏感请求
  • caches.match(event.request) 查缓存前,先用 new URL(event.request.url).origin === location.origin 过滤跨域请求,防止意外拦截 CDN 或第三方资源

fetch 事件中 return 与 event.respondWith() 的区别

fetch 事件监听器里,不能直接 return fetch(...),必须用 event.respondWith() 包裹响应 Promise。否则浏览器会忽略你的逻辑,走默认网络请求——这会导致离线时白屏,因为没拦截到请求。

常见错误写法:self.addEventListener('fetch', e => { if (e.request.url.endsWith('.png')) return caches.match(e.request); }) —— 这里 return 只是退出函数,不是响应请求。

  • 正确写法是:e.respondWith(caches.match(e.request).then(r => r || fetch(e.request)))
  • 注意 respondWith() 内部 Promise 必须 resolve 一个 Response 对象,不能是 nullundefined,否则报 TypeError: Failed to execute 'respondWith' on 'FetchEvent'
  • 想跳过缓存直连网络?仍需 e.respondWith(fetch(e.request)),不能省略包裹

调试离线行为时最该盯住的三个地方

离线效果不理想,往往不是代码写错,而是测试方式不对。重点看这三处:

  • Chrome DevTools 的 Application → Service Workers 面板右上角勾选 “Offline”,再刷新——别只关 WiFi,那可能还走本地 DNS 缓存或 HTTP/2 推送
  • Network 面板里每个请求的 “Size” 列显示 (from ServiceWorker) 才算真命中缓存;若显示 (from disk cache) 或空白,说明没走 SW
  • Console 里手动执行 caches.keys().then(keys => keys.forEach(k => caches.delete(k))) 清掉旧缓存,再重新 install,避免旧版本 SW 持续干扰

缓存策略看似简单,但 cache-firstnetwork-firststale-while-revalidate 的取舍,取决于资源更新频率和用户体验容忍度——这些细节不会报错,但会悄悄让离线体验变味。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

1056

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

837

2023.11.06

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

1056

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

837

2023.11.06

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

846

2023.08.22

while的用法
while的用法

while的用法是“while 条件: 代码块”,条件是一个表达式,当条件为真时,执行代码块,然后再次判断条件是否为真,如果为真则继续执行代码块,直到条件为假为止。本专题为大家提供while相关的文章、下载、课程内容,供大家免费下载体验。

106

2023.09.25

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 41.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号