性能中的概念
应用外壳(app shell)模型
发布于 更新于
应用外壳模型预缓存绘制 PWA 框架所需的最少 HTML、CSS、JavaScript 和图标,让首次访问之后的页面绘制不必等待网络。Service Worker 在安装时缓存外壳,后续导航从 Cache Storage 读取。外壳渲染完成后,页面再请求内容或读取数据缓存。
工作原理
链接到“工作原理”一节外壳包含各路由共用的界面:页眉、导航、布局骨架和渲染内容的脚本。Chrome 的应用外壳指南把它定义成驱动界面的最少 HTML、CSS 与 JavaScript,内容则动态加载。构建过程可以列出这些稳定资源,交给 Service Worker 的 install 事件缓存。随后,fetch 处理函数可用缓存的外壳文档应答导航请求,页面脚本再请求路由数据(The App Shell Model,developer.chrome.com)。
Cache Storage 与 HTTP 缓存是不同的存储。Service Workers 规范把 Cache Storage 定义成请求与响应的存储,并向 Service Worker 开放。缓存项按请求匹配,应用代码决定何时创建、替换或删除命名缓存。app-shell-v3 这类名称只是应用约定,不是浏览器保留名称。把外壳资源放进单独的命名缓存,激活处理函数便能删除旧外壳,同时避开无关的运行时响应。
版本与清理
链接到“版本与清理”一节外壳缓存可以用版本命名(app-shell-v3)。新部署换用新名称,新 Service Worker 的 install 填充新缓存,activate 处理函数则可删除名称以外壳前缀开头、但不等于当前名称的缓存。删除列表只选这个前缀,使用其他名称的运行时缓存和数据缓存(articles、images)不会入选。Service Workers 规范分别定义了安装、等待、激活和控制阶段;skipWaiting() 与 clients.claim() 会改变新 worker 进入下一阶段及控制客户端的时机。
外壳把界面资源与内容请求分开。Chrome 的指南同时介绍客户端渲染与服务端渲染,并指出外壳不是完整应用。客户端渲染可以从缓存取得外壳,再从 API 取得路由内容。服务端渲染则能让导航响应的 HTML 已经带有路由内容。应用还可以在离线导航时返回缓存外壳,网络可用时返回服务端渲染结果。
这种拆分要求代码明确处理内容失败。缓存里有外壳,并不表示 API 响应或路由数据也已缓存。数据请求失败时,页面应显示离线消息或已有缓存内容。下方的 fetch 处理函数在找不到 /shell.html 时还会请求原导航地址,不会把空的缓存匹配结果当成响应。
支持位置
链接到“支持位置”一节该模型建立在 Service Worker API 与 Cache Storage 之上,没有名为 appShell 的独立浏览器功能。兼容性数据记录 Service Worker 从 Chrome 40、Edge 17、Firefox 44 和 Safari 11.1 起受支持;其中 iOS Safari 条目沿用 Safari 数据(BCD api.ServiceWorker)。缺少 navigator.serviceWorker 时,注册示例会设置网络回退标记,不会尝试安装 worker。确定目标浏览器的回退方案前,可查阅Service Worker 兼容性数据。
Service Worker 负责预缓存和提供外壳,页面负责注册 worker。
预缓存外壳并用它应答导航
链接到“预缓存外壳并用它应答导航”一节安装步骤缓存外壳文档和资源;fetch 处理函数用外壳应答导航请求,其他请求缓存优先、网络兜底。
const SHELL = 'app-shell-v3';const SHELL_ASSETS = ['/shell.html', '/styles/app.css', '/scripts/app.js', '/icons/icon-192.png'];
self.addEventListener('install', (event) => { event.waitUntil(caches.open(SHELL).then((cache) => cache.addAll(SHELL_ASSETS)));});
self.addEventListener('activate', (event) => { event.waitUntil( caches.keys().then((keys) => Promise.all(keys.filter((k) => k.startsWith('app-shell-') && k !== SHELL).map((k) => caches.delete(k))) ) );});
self.addEventListener('fetch', (event) => { if (event.request.mode === 'navigate') { event.respondWith(caches.match('/shell.html').then((shell) => shell ?? fetch(event.request))); return; } event.respondWith(caches.match(event.request).then((hit) => hit ?? fetch(event.request)));});event.request.mode === 'navigate' 匹配导航请求。对于 Service Worker 作用域内的这类请求,处理函数会在缓存外壳可用时用它应答。
注册并在没有 Service Worker 时退回
链接到“注册并在没有 Service Worker 时退回”一节页面在 API 存在时注册 worker。API 不存在时,示例设置网络回退标记并返回,不注册 worker。Chrome 的应用外壳指南指出,不支持 Service Worker 的浏览器应得到回退体验,并把基本的服务端静态渲染作为许多选项之一。
async function enableShell() { if (!('serviceWorker' in navigator)) { document.documentElement.dataset.shell = 'network'; return; }
try { await navigator.serviceWorker.register('/sw.js'); document.documentElement.dataset.shell = 'service-worker'; } catch (error) { document.documentElement.dataset.shell = 'network'; console.warn('没有外壳缓存:', error); }}
enableShell();data-shell 属性让 CSS 或分析代码无需其他改动就能区分两种模式。
另请参阅
链接到“另请参阅”一节- The App Shell Model(developer.chrome.com)
- Offline and background operation(developer.mozilla.org)
- 预缓存策略
- 导航预加载与 Service Worker 启动时间
- 缓存策略
- 离线兜底
规范
| 规范 | 状态 |
|---|---|
| Service Worker | W3C 草案 |
- 图例
- 支持
- 部分支持
- 需开启标志
- 不支持
- 未知
| 浏览器 / 平台 | 支持 | 版本 | 置信度 | 来源 | 备注 |
|---|---|---|---|---|---|
| Chrome (Desktop)# | 支持 | 40 | 高 | 来源 | — |
| Chrome (Android)# | 支持 | 40 | 高 | 来源 | 1 |
| Edge (Desktop)# | 支持 | 17 | 高 | 来源 | — |
| Firefox (Desktop)# | 支持 | 44 | 高 | 来源 | — |
| Firefox (Android)# | 支持 | 44 | 高 | 来源 | 2 |
| Safari (macOS)# | 支持 | 11.1 | 高 | 来源 | — |
| Safari (iOS)# | 支持 | 11.3 | 高 | 来源 | 3 |
| Samsung Internet# | 支持 | 4.0 | 高 | 来源 | 4 |
| WebView (Android)# | 支持 | 40 | 高 | 来源 | 5 |
- 由 browser-compat-data 镜像自 Chrome 的数据推导。
- 由 browser-compat-data 镜像自 Firefox 的数据推导。
- 由 browser-compat-data 镜像自 Safari 的数据推导。
- 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
- 由 browser-compat-data 镜像自 Chrome Android 的数据推导。