[译]前端离线指南(上)

原文链接: 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.opencaches.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);
    });
  });
});

cacheAPI在页面既可以在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;
        });
      });
    })
  );
});

为了高效使用内存,只允许读取一次responserequestbody,在上面的代码中,使用.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被唤醒。您从页面请求执行此操作权限的同时,用户也将收到提示。

适用于: 不紧急的更新,尤其是那些定期进行的更新,每次更新都发送一个推送消息显得太频繁,比如社交时间表和新闻资讯。

你可能感兴趣的:(javascript,service-worker)