PWA 离线缓存怎么通过 Cache API 实现 Cache First 策略

阿敏小哥_8311

阿敏小哥_8311

2026-10-15

195人浏览

原创

cache first策略核心是优先从cache api读取资源,命中则返回,未命中再网络请求并缓存响应;适用于html、css、js等静态资源,提升离线体验与首屏速度。

pwa 离线缓存怎么通过 cache api 实现 cache first 策略

Cache First 策略的核心是:**优先从 Cache API 中读取资源,命中则直接返回;未命中再发起网络请求,并将响应存入缓存供后续使用**。它适合静态资源(如 HTML、CSS、JS、图标等),能显著提升离线体验和首屏加载速度。

注册 Service Worker 并监听 fetch 事件

必须在页面加载时注册 Service Worker,并在其内部拦截网络请求:

  • 确保主页面通过 navigator.serviceWorker.register('/sw.js') 注册,且 sw.js 与页面同源、位于根路径或合理 scope 下
  • 在 sw.js 中监听 fetch 事件,对匹配的请求执行 Cache First 逻辑
  • 注意:只对 GET 请求做缓存,避免缓存 POST/PUT 等非幂等请求

打开缓存并尝试匹配缓存项

使用 caches.open() 打开指定缓存空间,再用 cache.match(request) 查找匹配的响应:

anything-to-html
anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。

下载
  • 建议为不同资源类型(如 'static-v1'、'html-pages')创建独立缓存名,便于版本管理和清理
  • match() 默认精确匹配 URL 和 method,若需忽略 URL 参数或支持正则匹配,可传入 { ignoreSearch: true } 或自行解析 request.url
  • 若 match() 返回非 undefined 响应,直接 return response.clone()(避免流被消费两次)

缓存未命中时回退网络并写入缓存

当缓存无匹配时,发起 fetch(request),成功后将响应克隆并存入缓存:

  • 务必先 response.clone(),因为 Response body 是一次性流,不能被读取两次
  • 使用 cache.put(request, responseClone) 存入缓存——注意:request 必须是 Request 实例(不是字符串),否则会报错
  • 建议加 try/catch 包裹 fetch 和 put 操作,防止网络失败或存储异常导致整个请求失败
  • 对 HTML 页面可额外设置 ignoreVary: true(如 cache.match(req, { ignoreVary: true })),避免因 Vary 头导致重复缓存

缓存更新与版本控制

Cache First 不等于“永不更新”,需主动管理缓存生命周期:

  • 每次发布新版本时,修改缓存名(如从 'static-v1' → 'static-v2'),并在 install 阶段预缓存关键资源
  • 在 activate 事件中调用 caches.keys().then(keys => keys.filter(...).map(k => caches.delete(k))) 清理旧缓存
  • 对 HTML 文件,可结合 ETag 或 Last-Modified 做条件请求,或在 fetch 中对 HTML 单独采用 Stale-While-Revalidate 策略,兼顾新鲜度与可用性

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2463

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5283

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6350

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5918

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

843

5

Python uv使用教程
Python uv使用教程

本专题汇总了 Python uv 使用教程与高效使用指南,从 uv 安装配置、常用命令到虚拟环境、依赖管理与项目打包,系统讲解如何用 uv 替代 pip 与 poetry,全面提升 Python 项目开发效率,助你快速上手这一现代化包管理工具,打造干净高效的 Python 工作流。

2026.10.15

0

15

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习