React 同构应用 PWA 进级指南

2018/05/25 · JavaScript
· PWA,
React

初藳出处:
林东洲   

渐进式Web应用(PWA卡塔 尔(阿拉伯语:قطر‎入门教程(下卡塔 尔(英语:State of Qatar)

2018/05/25 · 功底本事 ·
PWA

初稿出处: Craig
Buckler   译文出处:葡萄城控件   

上篇随笔大家对渐进式Web应用(PWA卡塔 尔(英语:State of Qatar)做了有的主导的牵线。

渐进式Web应用(PWA卡塔尔国入门教程(上卡塔尔国

在那生机勃勃节中,我们将介绍PWA的原理是什么样,它是什么样伊始职业的。

行使 Service Worker 做一个 PWA 离线网页应用

2017/10/09 · JavaScript
· PWA, Service
Worker

原来的文章出处:
人人网FED博客   

在上后生可畏篇《自己是如何让网址用上HTML5
Manifest》介绍了怎么用Manifest做五个离线网页应用,结果被广大网上好友讥笑说那个事物已经被deprecated,移出web规范了,未来被ServiceWorker代替了,不管如何,Manifest的风流倜傥部分思量还能借用的。小编又将网址进级到了ServiceWorker,若是是用Chrome等浏览器就用瑟维斯Worker做离线缓存,假使是Safari浏览器就像故用Manifest,读者可以展开那些网址体会一下,断网也是能健康张开。

前言

前段时间在给笔者的博客网址 PWA 晋级,顺便就记录下 React 同构应用在动用 PWA
时遭受的主题材料,这里不会从头开首介绍如何是 PWA,借令你想学习 PWA
相关文化,能够看下上边笔者收藏的有的文章:

  • 您的首先个 Progressive Web
    App
  • 【ServiceWorker】生命周期那个事情
  • 【PWA学习与试行】(1)
    2018,起始你的PWA学习之旅
  • Progressive Web Apps (PWA)
    中文版

第一步:使用HTTPS

渐进式Web应用程序须要利用HTTPS连接。纵然使用HTTPS会令你服务器的开垦变多,但利用HTTPS能够令你的网址变得更安全,HTTPS网址在谷歌上的排行也会更靠前。

由于Chrome浏览器会暗中认可将localhost以至127.x.x.x地方视为测量检验地方,所以在本示例中你并无需开启HTTPS。其它,出于调节和测量检验目标,您能够在起步Chrome浏览器的时候使用以下参数来关闭其对网址HTTPS的检查:

  • –user-data-dir
  • –unsafety-treat-insecure-origin-as-secure

1. 什么是Service Worker

Service Worker是谷歌(Google卡塔 尔(阿拉伯语:قطر‎发起的兑现PWA(Progressive Web
App卡塔 尔(阿拉伯语:قطر‎的叁个要害剧中人物,PWA是为着消弭古板Web 应用程式的弱点:

(1卡塔尔未有桌面入口

(2卡塔尔不能离线使用

(3)没有Push推送

那瑟维斯 Worker的具体表现是什么样的啊?如下图所示:

威尼斯人平台 1

ServiceWorker是在后台运维的一条服务Worker线程,上海体育场合笔者开了七个标签页,所以体现了四个Client,可是不管开多少个页面都唯有二个Worker在担任管理。那个Worker的办事是把有个别财富缓存起来,然后拦截页面包车型大巴乞请,先看下缓存Curry有未有,要是局地话就从缓存里取,响应200,反之未有的话就走正规的伸手。具体来说,ServiceWorker结合Web App Manifest能到位以下职业(这也是PWA的检查实验正式卡塔尔国:

威尼斯人平台 2

席卷能够离线使用、断网时再次回到200、能提示顾客把网址增添三个Logo到桌面上等。

PWA 特性

PWA 不是只是的某项本领,而是一群技巧的集聚,举个例子:ServiceWorker,manifest 增添到桌面,push、notification api 等。

而就在明日时刻,IOS 11.3 刚刚扶助 Service worker 和周边 manifest
增多到桌面包车型的士表征,所以此次 PWA
更正着重依旧达成这两部分功效,至于其它的特征,等 iphone 援助了再升格吗。

其次步:创立二个应用程序清单(Manifest卡塔尔国

应用程序项目清单提供了和当下渐进式Web应用的连锁音信,如:

  • 应用程序名
  • 描述
  • 不无图片(满含主显示屏Logo,运维显示器页面和用的图样大概网页上用的图样卡塔 尔(英语:State of Qatar)

真相上讲,程序清单是页面上用到的Logo和主旨等能源的元数据。

程序项目清单是三个位居您使用根目录的JSON文件。该JSON文件重临时必需抬高Content-Type: application/manifest+json 或者 Content-Type: application/jsonHTTP头音信。程序项目清单的文书名不限,在本文的身体力行代码中为manifest.json

{ “name” : “PWA Website”, “short_name” : “PWA”, “description” : “An
example PWA website”, “start_url” : “/”, “display” : “standalone”,
“orientation” : “any”, “background_color” : “#ACE”, “theme_color” :
“#ACE”, “icons”: [ { “src” : “/images/logo/logo072.png”, “sizes” :
“72×72”, “type” : “image/png” }, { “src” : “/images/logo/logo152.png”,
“sizes” : “152×152”, “type” : “image/png” }, { “src” :
“/images/logo/logo192.png”, “sizes” : “192×192”, “type” : “image/png” },
{ “src” : “/images/logo/logo256.png”, “sizes” : “256×256”, “type” :
“image/png” }, { “src” : “/images/logo/logo512.png”, “sizes” :
“512×512”, “type” : “image/png” } ] }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
  "name"              : "PWA Website",
  "short_name"        : "PWA",
  "description"       : "An example PWA website",
  "start_url"         : "/",
  "display"           : "standalone",
  "orientation"       : "any",
  "background_color"  : "#ACE",
  "theme_color"       : "#ACE",
  "icons": [
    {
      "src"           : "/images/logo/logo072.png",
      "sizes"         : "72×72",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo152.png",
      "sizes"         : "152×152",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo192.png",
      "sizes"         : "192×192",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo256.png",
      "sizes"         : "256×256",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo512.png",
      "sizes"         : "512×512",
      "type"          : "image/png"
    }
  ]
}

程序清单文件构建完事后,你供给在种种页面上援引该公文:

<link rel=”manifest” href=”/manifest.json”>

1
<link rel="manifest" href="/manifest.json">

以下属性在程序清单中平时利用,介绍表明如下:

  • name: 顾客观望标运用名称
  • short_name: 应用短名称。当突显应用名称之处相当不足时,将接受该名称。
  • description: 选拔描述。
  • start_url: 行使初始路线,相对路线,默感觉/。
  • scope: U讴歌MDXL范围。比如:假使您将“/app/”设置为U本田CR-VL范围时,那一个动用就能够直接在此个目录中。
  • background_color: 接待页面包车型大巴背景颜色和浏览器的背景颜色(可选卡塔尔国
  • theme_color: 应用的大旨颜色,日常都会和背景颜色同样。这一个设置决定了运用怎么着呈现。
  • orientation: 预先旋转方向,可选的值有:any, natural, landscape,
    landscape-primary, landscape-secondary, portrait, portrait-primary,
    and portrait-secondary
  • display: 展现方式——fullscreen(无Chrome卡塔尔,standalone(和原生应用相似卡塔 尔(阿拉伯语:قطر‎,minimal-ui(最小的风流倜傥套UI控件集卡塔 尔(英语:State of Qatar)只怕browser(最古老的行使浏览器标签显示卡塔尔
  • icons: 贰个含有全部图片的数组。该数组中各样成分蕴含了图片的U路虎极光L,大小和连串。

2. Service Worker的支撑意况

Service Worker如今只有Chrome/Firfox/Opera支持:

威尼斯人平台 3

Safari和Edge也在预备协理Service Worker,由于ServiceWorker是谷歌(Google卡塔 尔(阿拉伯语:قطر‎大旨的后生可畏项专门的工作,对于生态相比较密闭的Safari来讲也是迫于时局开首打算扶植了,在Safari
TP版本,能够见见:

威尼斯人平台 4

在实验功能(Experimental Features卡塔 尔(英语:State of Qatar)里曾经有ServiceWorker的菜单项了,只是固然张开也是不能够用,会提示您还向来不落到实处:

威尼斯人平台 5

但随意如何,至少表明Safari已经策画扶植ServiceWorker了。其它还足以看来在当年前年二月揭橥的Safari
11.0.1版本已经协理WebRTC了,所以Safari照旧多少个升华的男女。

艾德ge也筹算扶助,所以Service Worker的前程非常美好。

Service Worker

service worker
在小编眼里,形似于一个跑在浏览器后台的线程,页面第三回加载的时候会加载那几个线程,在线程激活之后,通过对
fetch 事件,可以对各样收获的财富开展调整缓存等。

其三步:创造四个 瑟维斯 Worker

Service Worker
是二个可编程的服务器代理,它能够阻碍也许响应互联网需要。Service Worker
是位于应用程序根目录的多个个的JavaScript文件。

您必要在页直面应的JavaScript文件中登记该瑟维斯Worker:

if (‘serviceWorker’ in navigator) { // register service worker
navigator.serviceWorker.register(‘/service-worker.js’); }

1
2
3
4
if (‘serviceWorker’ in navigator) {
  // register service worker
  navigator.serviceWorker.register(‘/service-worker.js’);
}

风流倜傥旦您无需离线的连带职能,您可以只开创二个 /service-worker.js文本,那样顾客就足以直接设置您的Web应用了!

ServiceWorker那几个定义恐怕比较难懂,它实际上是叁个干活在任何线程中的标准的Worker,它不得以访谈页面上的DOM成分,没有页面上的API,然则可以阻挡全部页面上的网络恳求,富含页面导航,央求能源,Ajax央求。

地方就是运用全站HTTPS的首要原因了。假令你没有在您的网址中应用HTTPS,一个第三方的脚本就能够从其它的域名注入他本身的ServiceWorker,然后窜改全数的倡议——这确实是不行危险的。

Service Worker 会响应多个事件:install,activate和fetch。

3. 使用Service Worker

ServiceWorker的行使套路是先挂号三个Worker,然后后台就能够运维一条线程,能够在这里条线程运营的时候去加载一些财富缓存起来,然后监听fetch事件,在此个事件里拦截页面包车型大巴呼吁,先看下缓存里有未有,假使有直接重临,不然通常加载。恐怕是意气风发初步不缓存,各样能源央求后再拷贝生机勃勃份缓存起来,然后下一回倡议的时候缓存里就有了。

明朗什么财富需求被缓存?

那么在始发采纳 service worker 以前,首先必要驾驭怎么财富供给被缓存?

Install事件

该事件将要接纳设置完毕后触发。我们常常在此边运用Cache
API缓存一些必备的公文。

率先,大家需求提供如下配置

  1. 缓存名称(CACHE卡塔 尔(英语:State of Qatar)以致版本(version卡塔 尔(阿拉伯语:قطر‎。应用可以有三个缓存存款和储蓄,但是在使用时只会动用个中三个缓存存款和储蓄。每当缓存存款和储蓄有转移时,新的版本号将会钦赐到缓存存款和储蓄中。新的缓存存款和储蓄将会作为当前的缓存存储,在此以前的缓存存款和储蓄将会被作废。
  2. 八个离线的页面地址(offlineUPAJEROL卡塔 尔(英语:State of Qatar):当客商访谈了事先并未有访问过的地址时,该页面将会显示。
  3. 一个包涵了全数必需文件的数组,饱含保持页面不奇怪机能的CSS和JavaScript。在本示例中,小编还增加了主页和logo。当有两样的U福睿斯L指向同二个财富时,你也足以将这么些UENVISIONL分别写到那几个数组中。offlineULANDL将会加盟到那个数组中。
  4. 咱俩也足以将一些非必要的缓存文件(installFilesDesirable卡塔 尔(英语:State of Qatar)。那么些文件在装置进度中校会被下载,但若是下载战败,不会接触安装战败。

// 配置文件 const version = ‘1.0.0’, CACHE = version + ‘::PWAsite’,
offlineU帕杰罗L = ‘/offline/’, installFilesEssential = [ ‘/’,
‘/manifest.json’, ‘/css/styles.css’, ‘/js/main.js’,
‘/js/offlinepage.js’, ‘/images/logo/logo152.png’ ].concat(offlineURL),
installFilesDesirable = [ ‘/favicon.ico’, ‘/images/logo/logo016.png’,
‘/images/hero/power-pv.jpg’, ‘/images/hero/power-lo.jpg’,
‘/images/hero/power-hi.jpg’ ];

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 配置文件
const
  version = ‘1.0.0’,
  CACHE = version + ‘::PWAsite’,
  offlineURL = ‘/offline/’,
  installFilesEssential = [
    ‘/’,
    ‘/manifest.json’,
    ‘/css/styles.css’,
    ‘/js/main.js’,
    ‘/js/offlinepage.js’,
    ‘/images/logo/logo152.png’
  ].concat(offlineURL),
  installFilesDesirable = [
    ‘/favicon.ico’,
    ‘/images/logo/logo016.png’,
    ‘/images/hero/power-pv.jpg’,
    ‘/images/hero/power-lo.jpg’,
    ‘/images/hero/power-hi.jpg’
  ];

installStaticFiles() 方法运用基于Promise的不二秘技接纳Cache
API将文件存款和储蓄到缓存中。

// 安装静态财富 function installStaticFiles() { return
caches.open(CACHE) .then(cache => { // 缓存可选文件
cache.addAll(installFilesDesirable); // 缓存必得文件 return
cache.addAll(installFilesEssential); }); }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 安装静态资源
function installStaticFiles() {
  return caches.open(CACHE)
    .then(cache => {
      // 缓存可选文件
      cache.addAll(installFilesDesirable);
      // 缓存必须文件
      return cache.addAll(installFilesEssential);
    });
}

聊到底,大家抬高三个install的平地风波监听器。waitUntil主意有限支撑了service
worker不会设置直到其生死相依的代码被实行。这里它会举行installStaticFiles()方法,然后self.skipWaiting()方法来激活service
worker:

// 应用设置 self.addEventListener(‘install’, event => {
console.log(‘service worker: install’); // 缓存主要文件 event.waitUntil(
installStaticFiles() .then(() => self.skipWaiting()) ); });

1
2
3
4
5
6
7
8
9
10
11
12
// 应用安装
self.addEventListener(‘install’, event => {
  console.log(‘service worker: install’);
  // 缓存主要文件
  event.waitUntil(
    installStaticFiles()
    .then(() => self.skipWaiting())
  );
});

(1卡塔 尔(英语:State of Qatar)注册叁个Service Worker

Service Worker对象是在window.navigator里面,如下代码:

JavaScript

window.addEventListener(“load”, function() { console.log(“Will the
service worker register?”); navigator.serviceWorker.register(‘/sw-3.js’)
.then(function(reg){ console.log(“Yes, it did.”); }).catch(function(err)
{ console.log(“No it didn’t. This happened: “, err) }); });

1
2
3
4
5
6
7
8
9
window.addEventListener("load", function() {
    console.log("Will the service worker register?");
    navigator.serviceWorker.register(‘/sw-3.js’)
    .then(function(reg){
        console.log("Yes, it did.");
    }).catch(function(err) {
        console.log("No it didn’t. This happened: ", err)
    });
});

在页面load完事后注册,注册的时候传二个js文件给它,这么些js文件便是ServiceWorker的运营情形,倘诺不得不负众望注册的话就能够抛卓殊,如Safari
TP尽管有那个指标,不过会抛相当不能选拔,就足以在catch里面管理。这里有个难点是干什么需求在load事件运维呢?因为您要特别运维三个线程,运行以往你可能还恐怕会让它去加载财富,这么些都以需求占用CPU和带宽的,我们应当保险页面能健康加载完,然后再开发银行我们的后台线程,无法与常规的页面加载发生角逐,这么些在低级移动设备意义比较大。

再有一点索要在意的是ServiceWorker和Cookie同样是有Path路线的定义的,借使您设定多个cookie要是叫time的path=/page/A,在/page/B这一个页面是无法获取到那几个cookie的,假若设置cookie的path为根目录/,则持有页面都能获得到。相通地,倘使注册的时候使用的js路径为/page/sw.js,那么这么些ServiceWorker只能管理/page路线下的页面和财富,而不可见管理/api路径下的,所以平时把ServiceWorker注册到五星级目录,如上边代码的”/sw-3.js”,那样这么些ServiceWorker就能够接管页面的保有能源了。

缓存静态财富

首先是像 CSS、JS 那个静态财富,因为自个儿的博客里引用的脚本样式都是透过 hash
做长久化缓存,相通于:main.ac62dexx.js 那样,然后张开强缓存,那样后一次顾客后一次再拜望作者的网站的时候就无须再行央浼能源。直接从浏览器缓存中读取。对于那风华正茂部分财富,service
worker 没必要再去管理,直接放行让它去读取浏览器缓存就可以。

本人认为生龙活虎旦您的站点加载静态能源的时候本人未有展开强缓存,何况你只想通过前端去贯彻缓存,而无需后端在插足实行调治,那能够行使
service worker 来缓存静态能源,不然就有一点点适得其反了。

Activate 事件

本条事件会在service
worker被激活时爆发。你只怕无需以那一件事件,不过在演示代码中,大家在该事件时有产生时将老的缓存全体清理掉了:

// clear old caches function clearOldCaches() { return caches.keys()
.then(keylist => { return Promise.all( keylist .filter(key => key
!== CACHE) .map(key => caches.delete(key)) ); }); } // application
activated self.addEventListener(‘activate’, event => {
console.log(‘service worker: activate’); // delete old caches
event.waitUntil( clearOldCaches() .then(() => self.clients.claim())
); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// clear old caches
function clearOldCaches() {
  return caches.keys()
    .then(keylist => {
      return Promise.all(
        keylist
          .filter(key => key !== CACHE)
          .map(key => caches.delete(key))
      );
    });
}
// application activated
self.addEventListener(‘activate’, event => {
  console.log(‘service worker: activate’);
    // delete old caches
  event.waitUntil(
    clearOldCaches()
    .then(() => self.clients.claim())
    );
});

注意self.clients.claim()实行时将会把近来service
worker作为被激活的worker。

Fetch 事件
该事件将会在网络领头央浼时发起。该事件管理函数中,我们得以使用respondWith()主意来抑遏HTTP的GET必要然后回去:

  1. 从缓存中取到的财富文件
  2. 风流倜傥旦第一步失利,能源文件将会从网络中应用Fetch API来得到(和service
    worker中的fetch事件非亲非故卡塔尔。获取到的财富将会投入到缓存中。
  3. 设若第一步和第二步均未果,将会从缓存中回到准确的能源文件。

// application fetch network data self.addEventListener(‘fetch’, event
=> { // abandon non-GET requests if (event.request.method !== ‘GET’)
return; let url = event.request.url; event.respondWith(
caches.open(CACHE) .then(cache => { return cache.match(event.request)
.then(response => { if (response) { // return cached file
console.log(‘cache fetch: ‘ + url); return response; } // make network
request return fetch(event.request) .then(newreq => {
console.log(‘network fetch: ‘ + url); if (newreq.ok)
cache.put(event.request, newreq.clone()); return newreq; }) // app is
offline .catch(() => offlineAsset(url)); }); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// application fetch network data
self.addEventListener(‘fetch’, event => {
  // abandon non-GET requests
  if (event.request.method !== ‘GET’) return;
  let url = event.request.url;
  event.respondWith(
    caches.open(CACHE)
      .then(cache => {
        return cache.match(event.request)
          .then(response => {
            if (response) {
              // return cached file
              console.log(‘cache fetch: ‘ + url);
              return response;
            }
            // make network request
            return fetch(event.request)
              .then(newreq => {
                console.log(‘network fetch: ‘ + url);
                if (newreq.ok) cache.put(event.request, newreq.clone());
                return newreq;
              })
              // app is offline
              .catch(() => offlineAsset(url));
          });
      })
  );
});

offlineAsset(url)办法中选用了有个别helper方法来回到正确的数额:

// 是或不是为图片地址? let iExt = [‘png’, ‘jpg’, ‘jpeg’, ‘gif’, ‘webp’,
‘bmp’].map(f => ‘.’ + f); function isImage(url) { return
iExt.reduce((ret, ext) => ret || url.endsWith(ext), false); } //
return 再次来到离线能源 function offlineAsset(url) { if (isImage(url)) { //
重临图片 return new Response( ‘<svg role=”img” viewBox=”0 0 400 300″
xmlns=”
d=”M0 0h400v300H0z” fill=”#eee” /><text x=”200″ y=”150″
text-anchor=”middle” dominant-baseline=”middle” font-family=”sans-serif”
font-size=”50″ fill=”#ccc”>offline</text></svg>’, {
headers: { ‘Content-Type’: ‘image/svg+xml’, ‘Cache-Control’: ‘no-store’
}} ); } else { // return page return caches.match(offlineURL); } }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// 是否为图片地址?
let iExt = [‘png’, ‘jpg’, ‘jpeg’, ‘gif’, ‘webp’, ‘bmp’].map(f => ‘.’ + f);
function isImage(url) {
  
  return iExt.reduce((ret, ext) => ret || url.endsWith(ext), false);
  
}
  
  
// return 返回离线资源
function offlineAsset(url) {
  
  if (isImage(url)) {
  
    // 返回图片
    return new Response(
      ‘<svg role="img" viewBox="0 0 400 300" xmlns="http://www.w3.org/2000/svg"><title>offline</title><path d="M0 0h400v300H0z" fill="#eee" /><text x="200" y="150" text-anchor="middle" dominant-baseline="middle" font-family="sans-serif" font-size="50" fill="#ccc">offline</text></svg>’,
      { headers: {
        ‘Content-Type’: ‘image/svg+xml’,
        ‘Cache-Control’: ‘no-store’
      }}
    );
  
  }
  else {
  
    // return page
    return caches.match(offlineURL);
  
  }
  
}

offlineAsset()方法检查央求是不是为一个图形,然后回来叁个带有“offline”文字的SVG文件。别的央浼将会回去
offlineURubiconL 页面。

Chrome开拓者工具中的ServiceWorker部分提供了有关当前页面worker的消息。当中会展现worker中产生的错误,还足以强制刷新,也得以让浏览器步向离线格局。

Cache Storage
部分例举了当前怀有曾经缓存的财富。你能够在缓存要求更新的时候点击refresh按键。

(2卡塔 尔(阿拉伯语:قطر‎Service Worker安装和激活

登记完之后,ServiceWorker就能开展安装,这时会触发install事件,在install事件之中能够缓存一些财富,如下sw-3.js:

JavaScript

const CACHE_NAME = “fed-cache”; this.add伊芙ntListener(“install”,
function(event) { this.skipWaiting(); console.log(“install service
worker”); // 创制和开发二个缓存库 caches.open(CACHE_NAME); // 首页 let
cacheResources = [“];
event.waitUntil( // 央浼财富并加多到缓存里面去
caches.open(CACHE_NAME).then(cache => {
cache.addAll(cacheResources); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
const CACHE_NAME = "fed-cache";
this.addEventListener("install", function(event) {
    this.skipWaiting();
    console.log("install service worker");
    // 创建和打开一个缓存库
    caches.open(CACHE_NAME);
    // 首页
    let cacheResources = ["https://fed.renren.com/?launcher=true"];
    event.waitUntil(
        // 请求资源并添加到缓存里面去
        caches.open(CACHE_NAME).then(cache => {
            cache.addAll(cacheResources);
        })
    );
});

经过地点的操作,创制和增多了叁个缓存库叫fed-cache,如下Chrome调控台所示:

威尼斯人平台 6

ServiceWorker的API基本上都是再次回到Promise对象制止堵塞,所以要用Promise的写法。上边在安装ServiceWorker的时候就把首页的伸手给缓存起来了。在ServiceWorker的周转条件之中它有三个caches的全局对象,那么些是缓存的进口,还大概有二个常用的clients的大局对象,一个client对应三个标签页。

在ServiceWorker里面能够行使fetch等API,它和DOM是隔断的,未有windows/document对象,无法直接操作DOM,不能够直接和页面交互作用,在ServiceWorker里面不可能得悉当前页面打开了、当前页面的url是哪些,因为三个ServiceWorker管理当前开辟的多少个标签页,能够因此clients知道全数页面包车型客车url。还会有能够通过postMessage的法子和主页面相互传送消息和多少,进而做些调控。

install完未来,就能够触发Service Worker的active事件:

JavaScript

this.addEventListener(“active”, function(event) { console.log(“service
worker is active”); });

1
2
3
this.addEventListener("active", function(event) {
    console.log("service worker is active");
});

瑟维斯Worker激活之后就可以监听fetch事件了,大家期待每得到二个能源就把它缓存起来,就不要像上生机勃勃篇涉嫌的Manifest需求先生成叁个列表。

您只怕会问,当自家刷新页面包车型地铁时候不是又重新挂号安装和激活了一个ServiceWorker?就算又调了一遍注册,但并不会再也注册,它开掘”sw-3.js”这么些早就注册了,就不会再登记了,进而不会触发install和active事件,因为方今ServiceWorker已经是active状态了。当供给更新ServiceWorker时,如形成”sw-4.js”,大概改动sw-3.js的文本内容,就能够再也挂号,新的ServiceWorker会先install然后步向waiting状态,等到重启浏览器时,老的ServiceWorker就能够被更迭掉,新的ServiceWorker进入active状态,倘若不想等到再度启航浏览器能够像上边同样在install里面调skipWaiting:

JavaScript

this.skipWaiting();

1
this.skipWaiting();

缓存页面

缓存页面显著是必备的,那是最基本的部分,当你在离线的情景下加载页面会之后现身:

威尼斯人平台 7

究其原因正是因为您在离线状态下不可能加载页面,现在有了 service
worker,纵然你在没网络的情况下,也得以加载早先缓存好的页面了。

第四步:创立可用的离线页面

离线页面能够是静态的HTML,平常用来提示客户眼下伏乞的页面暂且不可能使用。可是,大家能够提供一些得以翻阅的页面链接。

Cache
API可以在main.js中动用。然则,该API使用Promise,在不辅助Promise的浏览器中会失利,全数的JavaScript试行会为此受到震慑。为了避免这种情状,在拜候/js/offlinepage.js的时候我们增加了风姿洒脱段代码来检查当前是还是不是在离线遭遇中:

/js/offlinepage.js 中以版本号为名称保存了方今的缓存,获取具有U魅影L,删除不是页面包车型客车U索罗德L,将这么些U传祺L排序然后将享有缓存的U奥迪Q5L体现在页面上:

// cache name const CACHE = ‘::PWAsite’, offlineURL = ‘/offline/’, list
= document.getElementById(‘cachedpagelist’); // fetch all caches
window.caches.keys() .then(cacheList => { // find caches by and order
by most recent cacheList = cacheList .filter(cName =>
cName.includes(CACHE)) .sort((a, b) => a – b); // open first cache
caches.open(cacheList[0]) .then(cache => { // fetch cached pages
cache.keys() .then(reqList => { let frag =
document.createDocumentFragment(); reqList .map(req => req.url)
.filter(req => (req.endsWith(‘/’) || req.endsWith(‘.html’)) &&
!req.endsWith(offlineURL)) .sort() .forEach(req => { let li =
document.createElement(‘li’), a =
li.appendChild(document.createElement(‘a’)); a.setAttribute(‘href’,
req); a.textContent = a.pathname; frag.appendChild(li); }); if (list)
list.appendChild(frag); }); }) });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// cache name
const
  CACHE = ‘::PWAsite’,
  offlineURL = ‘/offline/’,
  list = document.getElementById(‘cachedpagelist’);
// fetch all caches
window.caches.keys()
  .then(cacheList => {
    // find caches by and order by most recent
    cacheList = cacheList
      .filter(cName => cName.includes(CACHE))
      .sort((a, b) => a – b);
    // open first cache
    caches.open(cacheList[0])
      .then(cache => {
        // fetch cached pages
        cache.keys()
          .then(reqList => {
            let frag = document.createDocumentFragment();
            reqList
              .map(req => req.url)
              .filter(req => (req.endsWith(‘/’) || req.endsWith(‘.html’)) && !req.endsWith(offlineURL))
              .sort()
              .forEach(req => {
                let
                  li = document.createElement(‘li’),
                  a = li.appendChild(document.createElement(‘a’));
                  a.setAttribute(‘href’, req);
                  a.textContent = a.pathname;
                  frag.appendChild(li);
              });
            if (list) list.appendChild(frag);
          });
      })
  });

(3)fetch资源后cache起来

正如代码,监听fetch事件做些管理:

JavaScript

this.addEventListener(“fetch”, function(event) { event.respondWith(
caches.match(event.request).then(response => { // cache hit if
(response) { return response; } return
util.fetchPut(event.request.clone()); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
this.addEventListener("fetch", function(event) {
    event.respondWith(
        caches.match(event.request).then(response => {
            // cache hit
            if (response) {
                return response;
            }
            return util.fetchPut(event.request.clone());
        })
    );
});

先调caches.match看一下缓存里面是或不是有了,假设有一贯回到缓存里的response,否则的话平常央求财富并把它内置cache里面。放在缓存里能源的key值是Request对象,在match的时候,供给央求的url和header都风姿浪漫致才是相近的财富,能够设定首个参数ignoreVary:

JavaScript

caches.match(event.request, {ignoreVary: true})

1
caches.match(event.request, {ignoreVary: true})

表示假如央浼url类似就觉着是同三个能源。

地点代码的util.fetchPut是如此实现的:

JavaScript

let util = { fetchPut: function (request, callback) { return
fetch(request).then(response => { // 跨域的财富直接return if
(!response || response.status !== 200 || response.type !== “basic”) {
return response; } util.putCache(request, response.clone()); typeof
callback === “function” && callback(); return response; }); }, putCache:
function (request, resource) { // 后台不要缓存,preview链接也不要缓存 if
(request.method === “GET” && request.url.indexOf(“wp-admin”) < 0 &&
request.url.indexOf(“preview_id”) < 0) {
caches.open(CACHE_NAME).then(cache => { cache.put(request,
resource); }); } } };

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
let util = {
    fetchPut: function (request, callback) {
        return fetch(request).then(response => {
            // 跨域的资源直接return
            if (!response || response.status !== 200 || response.type !== "basic") {
                return response;
            }
            util.putCache(request, response.clone());
            typeof callback === "function" && callback();
            return response;
        });
    },
    putCache: function (request, resource) {
        // 后台不要缓存,preview链接也不要缓存
        if (request.method === "GET" && request.url.indexOf("wp-admin") < 0
              && request.url.indexOf("preview_id") < 0) {
            caches.open(CACHE_NAME).then(cache => {
                cache.put(request, resource);
            });
        }
    }
};

急需介怀的是跨域的能源不可能缓存,response.status会重返0,要是跨域的财富支持COCRUISERS,那么能够把request的mod改成cors。假诺诉求败北了,如404可能是过期等等的,那么也平昔回到response让主页面处理,否则的话表达加载成功,把这一个response克隆一个平放cache里面,然后再重返response给主页面线程。注意能缓慢存里的能源平日只可以是GET,通过POST获取的是不能够缓存的,所以要做个决断(当然你也得以手动把request对象的method改成get卡塔 尔(阿拉伯语:قطر‎,还会有把部分私家不愿意缓存的财富也做个推断。

那样假若客商张开过一回页面,ServiceWorker就设置好了,他刷新页面也许展开第二个页面包车型地铁时候就可以知道把央浼的财富大器晚成意气风发做缓存,满含图形、CSS、JS等,只要缓存里有了随意客户在线或然离线都能够符合规律采访。那样大家自然会有贰个标题,这么些缓存空间到底有多大?上生机勃勃篇大家提到Manifest也总算地点存款和储蓄,PC端的Chrome是5Mb,其实那一个说法在新本子的Chrome已经不确切了,在Chrome
61版本能够看见本地存款和储蓄的空间和选用境况:

威尼斯人平台 8

里头Cache Storage是指ServiceWorker和Manifest占用的长空尺寸和,上海体育场合能够看看总的空间大小是20GB,大约是unlimited,所以基本上不用操心缓存会非常不足用。

缓存后端接口数据

缓存接口数据是内需的,但亦非必须经过 service worker
来达成,前端寄存数据的地点有广大,譬如通过 localstorage,indexeddb
来进展仓库储存。这里自个儿也是通过 service worker
来落实缓存接口数据的,如若想透过别的方法来促成,只供给小心好 url
路线与数码对应的投射关系就可以。

开采者工具

Chrome浏览器提供了一有滋有味标工具来赞助你来调度瑟维斯Worker,日志也会一向呈现在调节台上。

您最佳应用匿超形式来展开开拓职业,那样能够铲除缓存对开采的骚扰。

最后,Chrome的Lighthouse扩张也可感觉你的渐进式Web应用提供一些更正消息。

(4)cache html

上面第(3卡塔尔国步把图纸、js、css缓存起来了,可是借使把页面html也缓存了,比方把首页缓存了,就能有三个啼笑皆非的难题——ServiceWorker是在页面注册的,可是今后获得页面的时候是从缓存取的,每一次都是同意气风发的,所以就产生无法矫正ServiceWorker,如产生sw-5.js,可是PWA又要求大家能缓存页面html。那如何是好吧?谷歌(Google卡塔 尔(英语:State of Qatar)的开荒者文书档案它只是提到会存在这里个主题材料,但并未有认证怎么消除这一个标题。这么些的难点的减轻就要求大家要有四个建制能分晓html更新了,进而把缓存里的html给替换掉。

Manifest更新缓存的机制是去看Manifest的公文内容有未有发生变化,假如发生变化了,则会去创新缓存,ServiceWorker也是根据sw.js的文书内容有未有产生变化,大家能够借鉴那几个思忖,假使央求的是html并从缓存里抽取来后,再发个须要获取一个文书看html更新时间是还是不是发生变化,假使发生变化了则印证产生变动了,进而把缓存给删了。所以能够在服务端通过调节这几个文件进而去校勘顾客端的缓存。如下代码:

JavaScript

this.addEventListener(“fetch”, function(event) { event.respondWith(
caches.match(event.request).then(response => { // cache hit if
(response) { //假使取的是html,则看发个央浼看html是还是不是更新了 if
(response.headers.get(“Content-Type”).indexOf(“text/html”) >= 0) {
console.log(“update html”); let url = new U智跑L(event.request.url);
util.updateHtmlPage(url, event.request.clone(), event.clientId); }
return response; } return util.fetchPut(event.request.clone()); }) );
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
this.addEventListener("fetch", function(event) {
 
    event.respondWith(
        caches.match(event.request).then(response => {
            // cache hit
            if (response) {
                //如果取的是html,则看发个请求看html是否更新了
                if (response.headers.get("Content-Type").indexOf("text/html") >= 0) {
                    console.log("update html");
                    let url = new URL(event.request.url);
                    util.updateHtmlPage(url, event.request.clone(), event.clientId);
                }
                return response;
            }
 
            return util.fetchPut(event.request.clone());
        })
    );
});

透过响应头header的content-type是或不是为text/html,借使是的话就去发个央求获取叁个文件,依照那几个文件的剧情决定是还是不是需求删除缓存,那些立异的函数util.updateHtmlPage是如此完结的:

JavaScript

let pageUpdateTime = { }; let util = { updateHtmlPage: function (url,
htmlRequest) { let pageName = util.getPageName(url); let jsonRequest =
new Request(“/html/service-worker/cache-json/” + pageName + “.sw.json”);
fetch(jsonRequest).then(response => { response.json().then(content
=> { if (pageUpdateTime[pageName] !== content.updateTime) {
console.log(“update page html”); // 假若有纠正则另行赢得html
util.fetchPut(htmlRequest); pageUpdateTime[pageName] =
content.updateTime; } }); }); }, delCache: function (url) {
caches.open(CACHE_NAME).then(cache => { console.log(“delete cache “

  • url); cache.delete(url, {ignoreVary: true}); }); } };
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
let pageUpdateTime = {
 
};
let util = {
    updateHtmlPage: function (url, htmlRequest) {
        let pageName = util.getPageName(url);
        let jsonRequest = new Request("/html/service-worker/cache-json/" + pageName + ".sw.json");
        fetch(jsonRequest).then(response => {
            response.json().then(content => {
                if (pageUpdateTime[pageName] !== content.updateTime) {
                    console.log("update page html");
                    // 如果有更新则重新获取html
                    util.fetchPut(htmlRequest);
                    pageUpdateTime[pageName] = content.updateTime;
                }
            });
        });
    },
    delCache: function (url) {
        caches.open(CACHE_NAME).then(cache => {
            console.log("delete cache " + url);
            cache.delete(url, {ignoreVary: true});
        });
    }
};

代码先去获取三个json文件,多少个页面会对应四个json文件,那一个json的剧情是这么的:

JavaScript

{“updateTime”:”10/2/2017, 3:23:57 PM”,”resources”: {img: [], css:
[]}}

1
{"updateTime":"10/2/2017, 3:23:57 PM","resources": {img: [], css: []}}

中间首要有三个updateTime的字段,假使地点内部存储器未有那些页面的updateTime的数额恐怕是和新型updateTime不雷同,则再一次去得到html,然后嵌入缓存里。接着必要布告页面线程数据发生变化了,你刷新下页面吗。那样就不用等客户刷新页面技能奏效了。所以当刷新完页面后用postMessage通告页面:

JavaScript

let util = { postMessage: async function (msg) { const allClients =
await clients.matchAll(); allClients.forEach(client =>
client.postMessage(msg)); } }; util.fetchPut(htmlRequest, false,
function() { util.postMessage({type: 1, desc: “html found updated”, url:
url.href}); });

1
2
3
4
5
6
7
8
9
let util = {
    postMessage: async function (msg) {
        const allClients = await clients.matchAll();
        allClients.forEach(client => client.postMessage(msg));
    }
};
util.fetchPut(htmlRequest, false, function() {
    util.postMessage({type: 1, desc: "html found updated", url: url.href});
});

并显然type: 1就代表那是三个翻新html的音信,然后在页面监听message事件:

JavaScript

if(“serviceWorker” in navigator) {
navigator.serviceWorker.addEventListener(“message”, function(event) {
let msg = event.data; if (msg.type === 1 && window.location.href ===
msg.url) { console.log(“recv from service worker”, event.data);
window.location.reload(); } }); }

1
2
3
4
5
6
7
8
9
if("serviceWorker" in navigator) {
    navigator.serviceWorker.addEventListener("message", function(event) {
        let msg = event.data;
        if (msg.type === 1 && window.location.href === msg.url) {
            console.log("recv from service worker", event.data);
            window.location.reload();
        }  
    });
}

下一场当我们要求更新html的时候就更新json文件,那样客商就能够看见最新的页面了。只怕是当客户重新开动浏览器的时候会变成ServiceWorker的周转内部存款和储蓄器都被清空了,即存款和储蓄页面更新时间的变量被清空了,那时候也会重复央求页面。

亟需小心的是,要把这一个json文件的http
cache时间设置成0,那样浏览器就不会缓存了,如下nginx的配备:

JavaScript

location ~* .sw.json$ { expires 0; }

1
2
3
location ~* .sw.json$ {
    expires 0;
}

因为那几个文件是急需实时获取的,不能被缓存,firefox暗中同意会缓存,Chrome不会,加上http缓存时间为0,firefox也不会缓存了。

还会有大器晚成种更新是顾客更新的,举个例子顾客宣布了商酌,供给在页面文告service
worker把html缓存删了再也获得,那是二个转头的音讯布告:

JavaScript

if (“serviceWorker” in navigator) {
document.querySelector(“.comment-form”).addEventListener(“submit”,
function() { navigator.serviceWorker.controller.postMessage({ type: 1,
desc: “remove html cache”, url: window.location.href} ); } }); }

1
2
3
4
5
6
7
8
9
10
if ("serviceWorker" in navigator) {
    document.querySelector(".comment-form").addEventListener("submit", function() {
            navigator.serviceWorker.controller.postMessage({
                type: 1,
                desc: "remove html cache",
                url: window.location.href}
            );
        }
    });
}

Service Worker也监听message事件:

JavaScript

const messageProcess = { // 删除html index 1: function (url) {
util.delCache(url); } }; let util = { delCache: function (url) {
caches.open(CACHE_NAME).then(cache => { console.log(“delete cache “

  • url); cache.delete(url, {ignoreVary: true}); }); } };
    this.addEventListener(“message”, function(event) { let msg = event.data;
    console.log(msg); if (typeof messageProcess[msg.type] === “function”)
    { messageProcess[msg.type](msg.url); } });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
const messageProcess = {
    // 删除html index
    1: function (url) {
        util.delCache(url);
    }
};
 
let util = {
    delCache: function (url) {
        caches.open(CACHE_NAME).then(cache => {
            console.log("delete cache " + url);
            cache.delete(url, {ignoreVary: true});
        });
    }
};
 
this.addEventListener("message", function(event) {
    let msg = event.data;
    console.log(msg);
    if (typeof messageProcess[msg.type] === "function") {
        messageProcess[msg.type](msg.url);
    }
});

基于分裂的音信类型调差异的回调函数,假使是1的话正是删除cache。顾客宣布完商议后会触发刷新页面,刷新的时候缓存已经被删了就能重新去乞请了。

那般就一蹴而就了实时更新的主题材料。

缓存计策

旗帜明显了哪些财富需求被缓存后,接下去将要斟酌缓存攻略了。

渐进式Web应用的焦点

渐进式Web应用是生机勃勃种新的技能,所以采用的时候必须要小心。也正是说,渐进式Web应用能够让你的网址在多少个钟头内获得校正,而且在不援助渐进式Web应用的浏览器上也不会潜移暗化网址的体现。

不过大家须要考虑以下几点:

4. Http/Manifest/Service Worker三种cache的关系

要缓存能够动用三种花招,使用Http
Cache设置缓存时间,也足以用Manifest的Application Cache,还足以用ServiceWorker缓存,假如三者都用上了会什么呢?

会以Service Worker为先行,因为ServiceWorker把央求拦截了,它首先做拍卖,借使它缓存Curry一些话一直重返,未有的话寻常央浼,就一定于还没ServiceWorker了,那时就到了Manifest层,Manifest缓存里若是局地话就取这些缓存,若无的话就一定于还未Manifest了,于是就能够从Http缓存里取了,若是Http缓存里也绝非就能够发央浼去获取,服务端依照Http的etag可能Modified
Time大概会再次来到304 Not
Modified,否则不荒谬再次回到200和数码内容。那便是整三个到手的历程。

之所以假若既用了Manifest又用ServiceWorker的话应该会招致同三个财富存了一遍。不过能够让扶持ServiceWorker的浏览器采取Service Worker,而不扶植的接收Manifest.

页面缓存计策

因为是 React
单页同构应用,每便加载页面包车型大巴时候数据都是动态的,所以作者动用的是:

  1. 互联网优先的方法,即优先获得网络上流行的能源。当互联网央求退步的时候,再去拿到service worker 里以前缓存的能源
  2. 当互联网加载成功未来,就纠正 cache
    中对应的缓存财富,保证后一次每便加载页面,都以上次作客的风靡财富
  3. 风华正茂旦找不到 service worker 中 url 对应的财富的时候,则去获取 service
    worker 对应的 /index.html 默许首页

// sw.js self.addEventListener(‘fetch’, (e) => {
console.log(‘今后正在呼吁:’ + e.request.url); const currentUrl =
e.request.url; // 相称上页面路径 if (matchHtml(currentUrl)) { const
requestToCache = e.request.clone(); e.respondWith( // 加载网络上的财富fetch(requestToCache).then((response) => { // 加载战败 if (!response
|| response.status !== 200) { throw Error(‘response error’); } //
加载成功,更新缓存 const responseToCache = response.clone();
caches.open(cacheName).then((cache) => { cache.put(requestToCache,
responseToCache); }); console.log(response); return response;
}).catch(function() { //
获取对应缓存中的数据,获取不到则失利到收获暗中认可首页 return
caches.match(e.request).then((response) => { return response ||
caches.match(‘/index.html’); }); }) ); } });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// sw.js
self.addEventListener(‘fetch’, (e) => {
  console.log(‘现在正在请求:’ + e.request.url);
  const currentUrl = e.request.url;
  // 匹配上页面路径
  if (matchHtml(currentUrl)) {
    const requestToCache = e.request.clone();
    e.respondWith(
      // 加载网络上的资源
      fetch(requestToCache).then((response) => {
        // 加载失败
        if (!response || response.status !== 200) {
          throw Error(‘response error’);
        }
        // 加载成功,更新缓存
        const responseToCache = response.clone();
        caches.open(cacheName).then((cache) => {
          cache.put(requestToCache, responseToCache);
        });
        console.log(response);
        return response;
      }).catch(function() {
        // 获取对应缓存中的数据,获取不到则退化到获取默认首页
        return caches.match(e.request).then((response) => {
           return response || caches.match(‘/index.html’);
        });
      })
    );
  }
});

何以存在命中不断缓存页面包车型客车情形?

  1. 率先必要了然的是,顾客在第1回加载你的站点的时候,加载页面后才会去运维sw,所以率先次加载不容许通过 fetch 事件去缓存页面
  2. 自己的博客是单页应用,可是客商并不一定会经过首页进入,有异常的大希望会透过其余页面路线步向到小编的网址,那就形成自身在
    install 事件中一贯不可能钦点供给缓存这几个页面
  3. 提及底完成的功能是:客户率先次打开页面,即刻断掉互连网,仍然能够离线访问作者的站点

组成方面三点,笔者的办法是:第二遍加载的时候会缓存 /index.html 那个能源,而且缓存页面上的数码,纵然客商及时离线加载的话,那个时候并不曾缓存对应的门道,比方 /archives 能源访谈不到,那再次回到 /index.html 走异步加载页面包车型客车逻辑。

在 install 事件缓存 /index.html,保证了 service worker
第一遍加载的时候缓存默许页面,留下退路。

import constants from ‘./constants’; const cacheName =
constants.cacheName; const apiCacheName = constants.apiCacheName; const
cacheFileList = [‘/index.html’]; self.addEventListener(‘install’, (e)
=> { console.log(‘Service Worker 状态: install’); const
cacheOpenPromise = caches.open(cacheName).then((cache) => { return
cache.addAll(cacheFileList); }); e.waitUntil(cacheOpenPromise); });

1
2
3
4
5
6
7
8
9
10
11
12
import constants from ‘./constants’;
const cacheName = constants.cacheName;
const apiCacheName = constants.apiCacheName;
const cacheFileList = [‘/index.html’];
 
self.addEventListener(‘install’, (e) => {
  console.log(‘Service Worker 状态: install’);
  const cacheOpenPromise = caches.open(cacheName).then((cache) => {
    return cache.addAll(cacheFileList);
  });
  e.waitUntil(cacheOpenPromise);
});

在页面加载完后,在 React 组件中马上缓存数据:

// cache.js import constants from ‘../constants’; const apiCacheName =
constants.apiCacheName; export const saveAPIData = (url, data) => {
if (‘caches’ in window) { // 假造 request/response 数据
caches.open(apiCacheName).then((cache) => { cache.put(url, new
Response(JSON.stringify(data), { status: 200 })); }); } }; // React 组件
import constants from ‘../constants’; export default class extends
PureComponent { componentDidMount() { const { state, data } =
this.props; // 异步加载数据 if (state === constants.INITIAL_STATE ||
state === constants.FAILURE_STATE) { this.props.fetchData(); } else {
// 服务端渲染成功,保存页面数据 saveAPIData(url, data); } } }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// cache.js
import constants from ‘../constants’;
const apiCacheName = constants.apiCacheName;
 
export const saveAPIData = (url, data) => {
  if (‘caches’ in window) {
    // 伪造 request/response 数据
    caches.open(apiCacheName).then((cache) => {
      cache.put(url, new Response(JSON.stringify(data), { status: 200 }));
    });
  }
};
 
// React 组件
import constants from ‘../constants’;
export default class extends PureComponent {
  componentDidMount() {
    const { state, data } = this.props;
    // 异步加载数据
    if (state === constants.INITIAL_STATE || state === constants.FAILURE_STATE) {
      this.props.fetchData();
    } else {
        // 服务端渲染成功,保存页面数据
      saveAPIData(url, data);
    }
  }
}

那样就保证了客户率先次加载页面,立即离线访问站点后,就算不恐怕像第一遍同样能够服务端渲染数据,不过随后能经过拿到页面,异步加载数据的章程创设离线应用。

威尼斯人平台 9

客商率先次访谈站点,如若在不刷新页面包车型客车情况切换路由到别的页面,则会异步获取到的数额,当下一次作客对应的路由的时候,则退步到异步获取数据。

威尼斯人平台 10

当顾客第三遍加载页面包车型大巴时候,因为 service worker
已经决定了站点,已经持有了缓存页面包车型大巴力量,之后在做客的页面都将会被缓存或许更新缓存,当用户离线访问的的时候,也能访谈到服务端渲染的页面了。

威尼斯人平台 11

URL隐藏

当你的施用正是二个单URAV4L的应用程序时(比如游戏卡塔 尔(英语:State of Qatar),小编提出您隐敝地址栏。除此而外的状态本人并不提出您隐蔽地址栏。在Manifest中,display: minimal-ui 或者 display: browser对于大好多状态来讲丰裕用了。

5. 运用Web App Manifest增添桌面入口

在乎这里说的是此外叁个Manifest,这些Manifest是叁个json文件,用来放网址icon名称等新闻以便在桌面增多几个Logo,以致创立少年老成种展开这几个网页就像展开App相符的法力。上面一贯说的Manifest是被裁撤的Application
Cache的Manifest。

本条Maifest.json文件能够如此写:

JavaScript

{ “short_name”: “人人FED”, “name”: “人人网FED,专一于前面叁个才具”,
“icons”: [ { “src”: “/html/app-manifest/logo_48.png”, “type”:
“image/png”, “sizes”: “48×48” }, { “src”:
“/html/app-manifest/logo_96.png”, “type”: “image/png”, “sizes”: “96×96”
}, { “src”: “/html/app-manifest/logo_192.png”, “type”: “image/png”,
“sizes”: “192×192” }, { “src”: “/html/app-manifest/logo_512.png”,
“type”: “image/png”, “sizes”: “512×512” } ], “start_url”:
“/?launcher=true”, “display”: “standalone”, “background_color”:
“#287fc5”, “theme_color”: “#fff” }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "short_name": "人人FED",
  "name": "人人网FED,专注于前端技术",
  "icons": [
    {
      "src": "/html/app-manifest/logo_48.png",
      "type": "image/png",
      "sizes": "48×48"
    },
    {
      "src": "/html/app-manifest/logo_96.png",
      "type": "image/png",
      "sizes": "96×96"
    },
    {
      "src": "/html/app-manifest/logo_192.png",
      "type": "image/png",
      "sizes": "192×192"
    },
    {
      "src": "/html/app-manifest/logo_512.png",
      "type": "image/png",
      "sizes": "512×512"
    }
  ],
  "start_url": "/?launcher=true",
  "display": "standalone",
  "background_color": "#287fc5",
  "theme_color": "#fff"
}

icon须要预备多种条件,最大须要512px *
512px的,那样Chrome会自动去选拔合适的图样。借使把display改成standalone,从转换的Logo张开就能够像张开一个App同样,未有浏览器地址栏那叁个东西了。start_url钦赐张开之后的输入链接。

下一场增加叁个link标签指向这几个manifest文件:

JavaScript

<link rel=”manifest” href=”/html/app-manifest/manifest.json”>

1
<link rel="manifest" href="/html/app-manifest/manifest.json">

如此组合Service Worker缓存:
威尼斯人平台 12把start_url指向的页面用ServiceWorker缓存起来,那样当顾客用Chrome浏览器张开那些网页的时候,Chrome就会在底层弹叁个提醒,询问客商是或不是把这些网页增加到桌面,假设点“增添”就能转换多个桌面Logo,从这一个Logo点进去就像张开一个App同样。心得如下:

威尼斯人平台 13

相比较窘迫的是Manifest如今独有Chrome扶植,而且一定要在安卓系统上接受,IOS的浏览器无法增加贰个桌面Logo,因为IOS未有开放这种API,但是本身的Safari却又是能够的。

综上,本文介绍了怎么用Service Worker结合Manifest做三个PWA离线Web
应用程式,首假设用ServiceWorker调整缓存,由于是写JS,比较灵活,还足以与页面举办通讯,其它通过诉求页面包车型大巴修正时间来推断是不是供给修改html缓存。ServiceWorker的包容性不是特意好,不过前景相比较光明,浏览器都在备选扶持。现阶段能够组成offline
cache的Manifest做离线应用。

连带阅读:

  1. 为何要把网址进级到HTTPS
  2. 什么样把网址进级到http/2
  3. 我是什么样让网址用上HTML5
    Manifest

1 赞 1 收藏
评论

威尼斯人平台 14

接口缓存战术

谈完页面缓存,再来说讲接口缓存,接口缓存就跟页面缓存很相近了,唯大器晚成的不等在于:页面第贰遍加载的时候不必然有缓存,但是会有接口缓存的存在(因为假造了
cache 中的数据),所以缓存计策跟页面缓存形似:

  1. 网络优先的章程,即优先获得互联网上接口数据。当网络诉求退步的时候,再去取得service worker 里在此之前缓存的接口数据
  2. 当网络加载成功以往,就校勘 cache
    中对应的缓存接口数据,保障后一次每回加载页面,都以上次拜望的流行接口数据

于是代码宛如那样(代码相近,不再赘述):

self.add伊芙ntListener(‘fetch’, (e) => { console.log(‘现在正在呼吁:’

  • e.request.url); const currentUrl = e.request.url; if
    (matchHtml(currentUrl)) { // … } else if (matchApi(currentUrl)) {
    const requestToCache = e.request.clone(); e.respondWith(
    fetch(requestToCache).then((response) => { if (!response ||
    response.status !== 200) { return response; } const responseToCache =
    response.clone(); caches.open(apiCacheName).then((cache) => {
    cache.put(requestToCache, responseToCache); }); return response;
    }).catch(function() { return caches.match(e.request); }) ); } });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
self.addEventListener(‘fetch’, (e) => {
  console.log(‘现在正在请求:’ + e.request.url);
  const currentUrl = e.request.url;
  if (matchHtml(currentUrl)) {
    // …
  } else if (matchApi(currentUrl)) {
    const requestToCache = e.request.clone();
    e.respondWith(
      fetch(requestToCache).then((response) => {
        if (!response || response.status !== 200) {
          return response;
        }
        const responseToCache = response.clone();
        caches.open(apiCacheName).then((cache) => {
          cache.put(requestToCache, responseToCache);
        });
        return response;
      }).catch(function() {
        return caches.match(e.request);
      })
    );
  }
});

此地实在能够再实行优化的,譬如在获取数据接口的时候,能够先读取缓存中的接口数据进行渲染,当真正的互联网接口数据再次回到之后再扩充沟通,那样也能管用裁减客户的首屏渲染时间。当然那也许会生出页面闪烁的效率,能够增加一些动画来扩充衔接。

缓存过大

你无法将您网站中的全数剧情缓存下来。对于小部分的网址的话缓存全部剧情并非一个题目,可是假使二个网址包括了上千个页面吗?很引人注目不是全体人对网址中的全体剧情都感兴趣。存款和储蓄是有限量的,要是您将具有访谈过的页面都缓存下来的话,缓存大小会增加额超快。

你能够如此制订你的缓存战术:

  • 只缓存首要的页面,比方主页,联系人页面和多年来浏览文章的页面。
  • 不用缓存任何图片,录像和大文件
  • 定期清理旧的缓存
  • 提供二个“离线阅读”按键,那样顾客就能够筛选供给缓存哪些内容了。

此外难点

到前几日截止,已经大半能够兑现 service worker
离线缓存应用的功能了,可是还会有如故存在一些难点:

缓存刷新

演示代码中在呼吁倡议此前会先查询缓存。当客商处于离线状态时,那很好,然而借使客商处于在线状态,那她只会浏览到比较老旧的页面。

种种能源比方图片和录像不会转移,所以日常都把这么些静态能源设置为漫漫缓存。那几个能源能够直接缓存一年(31,536,000秒卡塔尔。在HTTP
Header中,便是:

Cache-Control: max-age=31536000

1
Cache-Control: max-age=31536000

页面,CSS金华昆本文件也许调换的更频繁一些,所以您能够安装多少个十分的小的缓存超时时间(24钟头卡塔 尔(阿拉伯语:قطر‎,并确定保障在客户互联网连接恢复生机时再也从服务器诉求:

Cache-Control: must-revalidate, max-age=86400

1
Cache-Control: must-revalidate, max-age=86400

你也得以在历次网站发表时,通过更名的办法强制浏览重视新乞请财富。

不慢激活 service worker

默许情形下,页面包车型地铁伸手(fetch卡塔尔国不会由此 sw,除非它本身是通过 sw
获取的,也正是说,在设置 sw 之后,需求刷新页面技艺有功用。sw
在装置成功并激活在此之前,不会响应 fetch或push等事件。

因为站点是单页面应用,那就招致了你在切换路由(未有刷新页面)的时候从不缓存接口数据,因为那个时候service worker 还没起来专业,所以在加载 service worker
的时候供给急忙地激活它。代码如下:

self.addEventListener(‘activate’, (e) => { console.log(‘Service
Worker 状态: activate’); const cachePromise = caches.keys().then((keys)
=> { return Promise.all(keys.map((key) => { if (key !== cacheName
&& key !== apiCacheName) { return caches.delete(key); } return null;
})); }); e.waitUntil(cachePromise); // 飞快度与激情活 sw,使其能够响应 fetch
事件 return self.clients.claim(); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
self.addEventListener(‘activate’, (e) => {
  console.log(‘Service Worker 状态: activate’);
  const cachePromise = caches.keys().then((keys) => {
    return Promise.all(keys.map((key) => {
      if (key !== cacheName && key !== apiCacheName) {
        return caches.delete(key);
      }
      return null;
    }));
  });
  e.waitUntil(cachePromise);
  // 快速激活 sw,使其能够响应 fetch 事件
  return self.clients.claim();
});

部分随笔说还亟需在 install
事件中增多 self.skipWaiting(); 来跳过等待时间,不过本身在施行中发现即使不增多也得以寻常激活
service worker,原因未知,有读者知道的话能够调换下。

现今当您首先次加载页面,跳转路由,立即离线访谈的页面,也足以高枕而卧地加载页面了。

小结

由来,相信你风流罗曼蒂克旦依照本文一步一步操作下来,你也得以火速把温馨的Web应用转为PWA。在转为了PWA后,假诺有采用满意PWA
模型的前端控件的供给,你能够推行纯前端表格控件SpreadJS,适用于
.NET、Java 和移动端等平台的报表控件一定不会令你深负众望的。

原版的书文链接:

1 赞 1 收藏
评论

威尼斯人平台 14

不用强缓存 sw.js

客户每一趟访谈页面的时候都会去重新获得sw.js,依照文件内容跟从前的版本是不是风姿浪漫致来剖断 service worker
是不是有更正。所以就算你对 sw.js
开启强缓存的话,就将沦为死循环,因为每便页面获得到的 sw.js
没什么不相似,那样就不能升高你的 service worker。

其余对 sw.js 开启强缓存也是未有须求的:

  1. 作者 sw.js
    文件本身就相当小,浪费不了多少带宽,感到浪费能够行使合同缓存,但附加增加支出担当
  2. sw.js 是在页面空闲的时候才去加载的,并不会影响客户首屏渲染速度

制止改造 sw 的 URAV4L

在 sw 中那样做是“最差奉行”,要在原地方上改造 sw。

举个例证来申明为啥:

  1. index.html 注册了 sw-v1.js 作为 sw
  2. sw-v1.js 对 index.html 做了缓存,约等于缓存优先(offline-first卡塔 尔(英语:State of Qatar)
  3. 您更新了 index.html 重新注册了在新地方的 sw sw-v2.js

假使你像上边那么做,客商永世也拿不到 sw-v2.js,因为 index.html 在
sw-v1.js 缓存中,那样的话,假如你想翻新为 sw-v2.js,还亟需转移原本的
sw-v1.js。

测试

尔后,大家曾经到位了采用 service worker
对页面进行离线缓存的机能,假使想心得效果的话,访问小编的博客:

轻松浏览放肆的页面,然后关掉网络,再一次走访,以前您浏览过的页面都足以在离线的图景下开展访谈了。

IOS 要求 11.3 的本子才支撑,使用 Safari 进行访谈,Android 请选择帮忙service worker 的浏览器

manifest 桌面应用

前方说完了怎样行使 service worker 来离线缓存你的同构应用,可是 PWA
不独有限于此,你还足以选用安装 manifest
文件来将你的站点增加到活动端的桌面上,进而完结趋近于原生应用的体会。

使用 webpack-pwa-manifest 插件

本人的博客站点是透过 webpack 来创设前端代码的,所以我在社区里找到
webpack-pwa-manifest 插件用来生成 manifest.json。

第风度翩翩安装好 webpack-pwa-manifest 插件,然后在您的 webpack
配置文件中增进:

// webpack.config.prod.js const WebpackPwaManifest =
require(‘webpack-pwa-manifest’); module.exports =
webpackMerge(baseConfig, { plugins: [ new WebpackPwaManifest({ name:
‘Lindz’s Blog’, short_name: ‘Blog’, description: ‘An isomorphic
progressive web blog built by React & Node’, background_color: ‘#333’,
theme_color: ‘#333’, filename: ‘manifest.[hash:8].json’, publicPath:
‘/’, icons: [ { src: path.resolve(constants.publicPath, ‘icon.png’),
sizes: [96, 128, 192, 256, 384, 512], // multiple sizes destination:
path.join(‘icons’) } ], ios: { ‘apple-mobile-web-app-title’: ‘Lindz’s
Blog’, ‘apple-mobile-web-app-status-bar-style’: ‘#000’,
‘apple-mobile-web-app-capable’: ‘yes’, ‘apple-touch-icon’:
‘//xxx.com/icon.png’, }, }) ] })

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// webpack.config.prod.js
const WebpackPwaManifest = require(‘webpack-pwa-manifest’);
module.exports = webpackMerge(baseConfig, {
  plugins: [
    new WebpackPwaManifest({
      name: ‘Lindz’s Blog’,
      short_name: ‘Blog’,
      description: ‘An isomorphic progressive web blog built by React & Node’,
      background_color: ‘#333’,
      theme_color: ‘#333’,
      filename: ‘manifest.[hash:8].json’,
      publicPath: ‘/’,
      icons: [
        {
          src: path.resolve(constants.publicPath, ‘icon.png’),
          sizes: [96, 128, 192, 256, 384, 512], // multiple sizes
          destination: path.join(‘icons’)
        }
      ],
      ios: {
        ‘apple-mobile-web-app-title’: ‘Lindz’s Blog’,
        ‘apple-mobile-web-app-status-bar-style’: ‘#000’,
        ‘apple-mobile-web-app-capable’: ‘yes’,
        ‘apple-touch-icon’: ‘//xxx.com/icon.png’,
      },
    })
  ]
})

简单地阐释下安插新闻:

  1. name: 应用名称,就是Logo上面的来得名称
  2. short_name: 应用名称,但 name 不可能出示完全时候则显示这几个
  3. background_color、theme_color:看名就会猜到其意义,相应的颜料
  4. publicPath: 设置 cdn 路径,跟 webpack 里的 publicPath 一样
  5. icons: 设置Logo,插件会自动帮你转移不一致 size
    的图样,可是图片大小必得大于最大 sizes
  6. ios: 设置在 safari 中哪些去增添桌面应用

安装完事后,webpack 会在创设进度中生成对应的 manifest 文件,并在 html
文件中援用,上面正是生成 manifest 文件:

{ “icons”: [ { “src”:
“/icons/icon_512x512.79ddc5874efb8b481d9a3d06133b6213.png”, “sizes”:
“512×512”, “type”: “image/png” }, { “src”:
“/icons/icon_384x384.09826bd1a5d143e05062571f0e0e86e7.png”, “sizes”:
“384×384”, “type”: “image/png” }, { “src”:
“/icons/icon_256x256.d641a3644ce20c06855db39cfb2f7b40.png”, “sizes”:
“256×256”, “type”: “image/png” }, { “src”:
“/icons/icon_192x192.8f11e077242cccd9c42c0cbbecd5149c.png”, “sizes”:
“192×192”, “type”: “image/png” }, { “src”:
“/icons/icon_128x128.cc0714ab18fa6ee6de42ef3d5ca8fd09.png”, “sizes”:
“128×128”, “type”: “image/png” }, { “src”:
“/icons/icon_96x96.dbfccb1a5cef8093a77c079f761b2d63.png”, “sizes”:
“96×96”, “type”: “image/png” } ], “name”: “Lindz’s Blog”,
“short_name”: “Blog”, “orientation”: “portrait”, “display”:
“standalone”, “start_url”: “.”, “description”: “An isomorphic
progressive web blog built by React & Node”, “background_color”:
“#333”, “theme_color”: “#333” }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
  "icons": [
    {
      "src": "/icons/icon_512x512.79ddc5874efb8b481d9a3d06133b6213.png",
      "sizes": "512×512",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_384x384.09826bd1a5d143e05062571f0e0e86e7.png",
      "sizes": "384×384",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_256x256.d641a3644ce20c06855db39cfb2f7b40.png",
      "sizes": "256×256",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_192x192.8f11e077242cccd9c42c0cbbecd5149c.png",
      "sizes": "192×192",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_128x128.cc0714ab18fa6ee6de42ef3d5ca8fd09.png",
      "sizes": "128×128",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_96x96.dbfccb1a5cef8093a77c079f761b2d63.png",
      "sizes": "96×96",
      "type": "image/png"
    }
  ],
  "name": "Lindz’s Blog",
  "short_name": "Blog",
  "orientation": "portrait",
  "display": "standalone",
  "start_url": ".",
  "description": "An isomorphic progressive web blog built by React & Node",
  "background_color": "#333",
  "theme_color": "#333"
}

html 中会援引这些文件,况兼增进对 ios 增多桌面应用的支撑,好似那样。

<!DOCTYPE html> <html lang=en> <head> <meta
name=apple-mobile-web-app-title content=”Lindz’s Blog”> <meta
name=apple-mobile-web-app-capable content=yes> <meta
name=apple-mobile-web-app-status-bar-style content=#838a88> <link
rel=apple-touch-icon href=xxxxx> <link rel=manifest
href=/manifest.21d63735.json> </head> </html>

1
2
3
4
5
6
7
8
9
10
<!DOCTYPE html>
<html lang=en>
<head>
  <meta name=apple-mobile-web-app-title content="Lindz’s Blog">
  <meta name=apple-mobile-web-app-capable content=yes>
  <meta name=apple-mobile-web-app-status-bar-style content=#838a88>
  <link rel=apple-touch-icon href=xxxxx>
  <link rel=manifest href=/manifest.21d63735.json>
</head>
</html>

就这么简单,你就足以运用 webpack 来加多你的桌面应用了。

测试

加多完之后你能够通过 chrome 开荒者工具 Application – Manifest 来查看你的
mainfest 文件是或不是见到成效:

威尼斯人平台 16

那般表明您的安顿生效了,安卓机遇自动识别你的陈设文件,并问询客户是不是丰硕。

结尾

讲到这基本上就完了,等之后 IOS 援助 PWA
的此外功用的时候,届时候作者也会相应地去实行此外 PWA 的风味的。未来 IOS
11.3 也仅仅援助 PWA 中的 service worker 和 app manifest
的效果,可是相信在不久的现在,此外的功效也会相应获得帮助,届期候相信 PWA
将会在活动端怒放异彩的。

1 赞 收藏
评论

威尼斯人平台 14

相关文章