跳转到内容

性能中的概念

应用外壳(app shell)模型

发布于 更新于

自 2018-04 起广泛可用W3C 草案

应用外壳模型预缓存绘制 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 或分析代码无需其他改动就能区分两种模式。

规范

规范状态
Service WorkerW3C 草案
  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
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
  1. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  2. 由 browser-compat-data 镜像自 Firefox 的数据推导。
  3. 由 browser-compat-data 镜像自 Safari 的数据推导。
  4. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
  5. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。

源数据: /compatibility/service-worker.json · 全球使用占比: 96 % (StatCounter 2026-09, CC BY-SA 4.0)

来源: 规范 · MDN · 最近核验 2026-10-20 · 置信度: 高 (由来源计算)