原文链接: The offline cookbook
作者:Jake Archibald
使用AppCache可以为我们提供几种支持内容离线工作的模式。如果这些模式正是你所需要的,那么恭喜你,你中了APPCache的大奖(尽管头等奖依然无人认领),但我们这些其余的人都挤在角落里来回摇摆(译者注:作者指的是由于设计上的原因,AppCache逐渐地被Web标准移除,虽然现在依然有浏览器支持这个功能,但最好不要再使用它了)
对于ServiceWorker(介绍),我们放弃尝试去解决离线问题,并且给开发者们提供灵活的组件从而让他们自己去解决离线问题。它为您提供了控制缓存和处理请求的方式。这就意味着您可以创建您自己的模式。接下来让我们来看一下几个隔离环境下的可行模式,但是在实践中,您可能会根据URL和context以串联方式用到其中的多个模式。
目前,除非另有说明,所有的示例代码都可以运行在Chrome和Firefox浏览器中。关于ServiceWorker支持程度的完整详情,请查阅"Is Service Worker Ready?"。
有关对于其中部分模式的运行演示,请查阅Trained-to-thrill,并且此处的视频将向您展示性能影响。
缓存机-何时开始存储资源?
您可以通过ServiceWorker来独立地从缓存中处理请求,所以我们要先单独地研究一下它们。首先,我们啥时候应该进行缓存呢?
安装时——以依赖的形式
ServiceWorker提供给您一个install
事件,您可以使用它把资源准备好,即在处理其他事件之前必须要提前准备好的东西。但是当这些操作正在进行中的时候,任何旧版本的ServiceWorker仍旧在运行并且提供给页面,因此您在此处进行的操作一定不能中断它们。
适用于: CSS、图片、字体、JS文件、模板等,基本包含了你认为网站在当前“版本”中应该需要的所有静态资源。
如果未能获取上述资源,那么您的网站完全无法运行,对应的本机应用会将这些对象包含在初始下载中。
self.addEventListener('install', function(event) {
event.waitUntil(
caches.open('mysite-static-v3').then(function(cache) {
return cache.addAll([
'/css/whatever-v3.css',
'/css/imgs/sprites-v6.png',
'/css/fonts/whatever-v8.woff',
'/js/all-min-v4.js'
// etc
]);
})
);
});
event.waitUntil
接受一个promise对象作参数,来定义安装时长和安装是否成功,如果promise状态为rejected,则认为此次安装失败,并且抛弃ServiceWorker(如果一个旧版本的ServiceWorker正在运行,则它将保持不变)。caches.open
和caches.addAll
都返回promise对象,如果其中有任何一个资源获取失败,则caches.addAll
会调用reject。
在trained-to-thrill 上,我使用此方法缓存静态资源。
安装时——不作为依赖
此方式与上述相似,但区别是:即使缓存失败,既不会延迟安装也不会导致安装失败。
适用于: 体积较大的,且暂时用不到的资源,比如用于游戏的较高级别的资源。
self.addEventListener('install', function(event) {
event.waitUntil(
caches.open('mygame-core-v1').then(function(cache) {
cache.addAll(
// levels 11-20
);
return cache.addAll(
// core assets & levels 1-10
);
})
);
});
我们没有将levels 11-20的cache.addAll
promise对象,返回给event.waitUntil
,所以事件即使失败,游戏在离线的时候依然可以使用。当然,您必须考虑到缺少这些level的情况,如果缺少它们,则尝试重新缓存它们。
在当level 11-20正在下载的时候,ServiceWorker可能会终止,因为它已经完成处理事件。这就意味着它们就不会被缓存下来。未来,我们计划添加一个在后台下载的API以处理类似这样的情况,以及下载像电影一样的大体积文件。
激活时
适用于: 清理和迁移
在新的ServiceWorker已经被安装,并且较早版本的sw没有在使用的情况下,则新的ServiceWorker会被激活,您就会得到一个activate事件。由于旧版本的退出,所以此时非常适合处理 IndexedDB 中的架构迁移和删除未使用的缓存。
self.addEventListener('activate', function(event) {
event.waitUntil(
caches.keys().then(function(cacheNames) {
return Promise.all(
cacheNames.filter(function(cacheName) {
// 如果您想删除缓存,则返回true,
// 但是请记住缓存在该域名内的所有页面之间
// 是共享的
}).map(function(cacheName) {
return caches.delete(cacheName);
})
);
})
);
});
在激活的过程中,诸如fetch
等事件会被放置在一个队列中,所以一个长时间的激活可能会阻塞页面加载。保证您的激活尽可能地简洁,仅用于旧版本处于活动状态时无法执行的操作。
在trained-to-thrill上,我使用此方法移除旧缓存。
在用户交互时
适用于: 如果整个站点无法离线工作,您可以允许用户选择需要离线的可用内容,比如,YouTube上的某个视频,维基百科上的某篇文章,Flickr上的某张图片等等。
为用户提供一个“稍后阅读”或者“离线保存”的按钮。当点击按钮,从网络中获取您所需要的内容并把它放进缓存中。
document.querySelector('.cache-article').addEventListener('click', function(event) {
event.preventDefault();
var id = this.dataset.articleId;
caches.open('mysite-article-' + id).then(function(cache) {
fetch('/get-article-urls?id=' + id).then(function(response) {
// /get-article-urls returns a JSON-encoded array of
// resource URLs that a given article depends on
return response.json();
}).then(function(urls) {
cache.addAll(urls);
});
});
});
cache
API在页面既可以在ServiceWorker中获取到,也可以在页面中获取到,这就意味着你不必一定要通过ServiceWorker来向缓存中添加内容。
网络响应时
适用于: 频繁更新的资源,比如用户收件箱,或者文章内容。同样适用于不重要但需要谨慎处理的内容,比如用户头像。
如果请求的资源与缓存中的任何资源均不匹配,则从网络中获取,将其发送到页面中,同时将其添加到缓存中。
如果您针对一系列网址执行此操作,如头像,那么您需要谨慎,不要使域名下的存储变得臃肿,如果用户需要回收磁盘空间,您不会想成为主要候选对象。请确保将缓存中不再需要的项目删除。
self.addEventListener('fetch', function(event) {
event.respondWith(
caches.open('mysite-dynamic').then(function(cache) {
return cache.match(event.request).then(function (response) {
return response || fetch(event.request).then(function(response) {
cache.put(event.request, response.clone());
return response;
});
});
})
);
});
为了高效使用内存,只允许读取一次response
或request
的body
,在上面的代码中,使用.clone
来创建能够单独地读取数据的额外副本。
在trained-to-thrill上,我使用此方法缓存Flickr图像。
Stale-while-revalidate
适用于: 频繁更新,但却没必要获取最新的资源。用户头像就属于此类。
如果缓存中已经有一个可用的版本,直接使用该版本,但是会为了下一次的请求而获取一个更新版本。
self.addEventListener('fetch', function(event) {
event.respondWith(
caches.open('mysite-dynamic').then(function(cache) {
return cache.match(event.request).then(function(response) {
var fetchPromise = fetch(event.request).then(function(networkResponse) {
cache.put(event.request, networkResponse.clone());
return networkResponse;
})
return response || fetchPromise;
})
})
);
});
它和 HTTP 的 stale-while-revalidate 非常相似。
推送消息时
注意: Chrome暂时还不支持Push。(译者注:Chrome 50及之后的版本开始支持,更多信息请参考 can i use)
Push API是基于ServiceWorker构建的另一个功能。它允许唤醒ServiceWorker以响应来自系统服务的消息,即使用户没有为您的站点打开一个标签,Push API也同样可以工作。只有ServiceWorker被唤醒。您从页面请求执行此操作权限的同时,用户也将收到提示。
适用于: 与通知有关的内容,比如聊天消息,突发新闻,或者Email等。同样适用于不经常更改的可立即同步的内容,例如待办事项更新或者日程表的更改。
用户常见的页面表现是,出现一个通知,当点击它的时候,会打开或者聚焦到相关的页面,但是在点击它之前,务必要更新缓存。显然,用户在收到推送消息的时候,一定是在线的,但是,当他们最终与通知交互时可能已经离线,因此,允许离线访问此内容非常重要。Twitter原生应用在大多数情况下都是非常好的离线优先例子,但在这点上却有点小问题。
如果没有网络连接,Twitter无法提供与推送消息相关的内容。但是点按通知会移除通,从而使用户获取的信息比点按通知之前还要少。不要这么做!
下面的代码会在展示通知之前更新缓存。
self.addEventListener('push', (event) => {
if (event.data.text() == 'new-email') {
event.waitUntil(async function() {
const cache = await caches.open('mysite-dynamic');
const response = await fetch('/inbox.json');
await cache.put('/inbox.json', response.clone());
const emails = await response.json();
registration.showNotification("New email", {
body: "From " + emails[0].from.name
tag: "new-email"
});
}());
}
});
self.addEventListener('notificationclick', function(event) {
if (event.notification.tag == 'new-email') {
// Assume that all of the resources needed to render
// /inbox/ have previously been cached, e.g. as part
// of the install handler.
new WindowClient('/inbox/');
}
});
后台同步时
注意: 后台同步尚未加入到Chrome稳定版本中。(译者注:Chrome 49及之后的版本中开始支持,但FireFox、Safari尚未支持,更多信息请参考 can i use)
后台同步是基于ServiceWorker来构建的另一个功能。它允许您一次性地,或者按照(非常具有启发性的)时间间隔来请求后台数据同步。即使用户没有为您的站点打开一个标签,后台同步也同样可以工作。只有ServiceWorker被唤醒。您从页面请求执行此操作权限的同时,用户也将收到提示。
适用于: 不紧急的更新,尤其是那些定期进行的更新,每次更新都发送一个推送消息显得太频繁,比如社交时间表和新闻资讯。