SuperAPI AI 工具集

service-worker

通用与其它

查看项目

更新于 10-16 03:49

技能介绍

用途:在原生 JavaScript 项目中实现 Service Worker,提供离线支持、智能缓存与 PWA 能力,不使用 Workbox 等抽象库。主张渐进增强(无 SW 站点也能正常运行)、可预测(带版本号的缓存与明确策略)、可调试(日志与清晰更新路径)、轻量(无需框架)。

主要能力:Service Worker 注册与更新处理(监听 updatefound、通过 postMessage 发送 SKIP_WAITING、controllerchange 后重载);install 阶段预缓存资源列表;activate 阶段清理旧缓存并 clients.claim;fetch 事件按请求类型分发策略。内置策略包括 cacheFirst(CSS、JS、字体、图片等少变资源)、networkFirst(API 与动态内容)、networkFirstWithOffline(HTML 导航,失败时回退 offline.html 或 503 响应)、staleWhileRevalidate(博客、商品页等可接受旧内容者)。提供按内容类型选择策略的对照表、离线页示例、缓存版本管理(手动版本号、构建哈希或构建生成的版本文件)。

使用方式:在 src 下放置 sw.js、可选的 sw-assets.js 预缓存清单与 js/sw-register.js 注册脚本;通过 navigator.serviceWorker.register('/sw.js', { scope: '/' }) 注册,注册后调用 registration.update(),更新时派发自定义事件 sw-update-available,由用户确认后调用 acceptUpdate 触发 skipWaiting 并重载。fetch 中仅处理同源 GET 请求,跳过非 GET 与跨域请求,并按 isNavigationRequest、isStaticAsset、isApiRequest 判断选择策略。PWA 部分通过 manifest.webmanifest 的 link 与 name、short_name、start_url、display、icons 等字段配合。可选 background sync 用 registration.sync.register('sync-data') 排队失败请求,并在 SW 的 sync 事件中重试。

适用场景:需要离线优先、缓存控制或 PWA 功能的原生 JS 站点与应用。

限制与注意:不拦截非 GET 与跨域请求;仅缓存 response.ok 的成功响应;避免无条件 skipWaiting;需在 activate 清理旧缓存并限制缓存大小;CACHE_VERSION 须随预缓存资源变更递增;开发时可用 DevTools 的 Application、Cache Storage、Network 面板及注销脚本强制更新。资料未提供具体安装命令、外部依赖版本、收费与价格信息,也未给出各策略的性能数据。