入门教程澳门金莎娱乐网站:,离线网页应用

日期:2019-10-02编辑作者:澳门金莎娱乐网站

运用 Service Worker 做三个 PWA 离线网页应用

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

初稿出处: 人人网FED博客   

在上一篇《本身是哪些让网址用上HTML5 Manifest》介绍了怎么用Manifest做二个离线网页应用,结果被大规模网络朋友作弄说这一个事物已经被deprecated,移出web规范了,今后被ServiceWorker替代了,不管怎么着,Manifest的一对思索还能借用的。笔者又将网址进级到了ServiceWorker,若是是用Chrome等浏览器就用ServiceWorker做离线缓存,假设是Safari浏览器就依旧用Manifest,读者能够展开这一个网址感受一下,断网也是能平常打开。

渐进式Web应用(PWA)入门教程(下)

2018/05/25 · 基础才能 · PWA

原稿出处: Craig Buckler   译文出处:菩提子城控件   

上篇文章大家对渐进式Web应用(PWA)做了有个别主导的牵线。

渐进式Web应用(PWA)入门教程(上)

在这一节中,大家将介绍PWA的原理是什么样,它是什么样伊始工作的。

运用 Service worker 创造二个特别轻松的离线页面

2016/06/07 · JavaScript · 1 评论 · Service Worker

本文由 伯乐在线 - 刘健超-J.c 翻译,艾凌风 校稿。未经许可,幸免转发!
意大利语出处:Dean Hume。迎接出席翻译组。

让大家想像以下情状:大家那儿在一辆通往农村的列车的里面,用移动设备瞧着一篇很棒的篇章。与此同不经常候,当您点击“查看更加多”的链接时,火车忽地步向了隧道,导致移动器械失去了网络,而 web 页面会展现出类似以下的源委:

澳门金莎娱乐网站 1

这是一定令人衰颓的经验!幸运的是,web 开采者们能经过一些新特点来改良那类的客商体验。作者近年径直在折腾 ServiceWorkers,它给 web 带来的数不清大概性总能给本人欢腾。Service Workers 的精美国特务职业人士人士质之一是允许你检验网络央浼的情景,并让您作出相应的响应。

在那篇作品里,作者计划用此性子检查客户的当下网络连接情形,要是没连接则赶回二个特级轻易的离线页面。即使那是八个十二分基础的案例,但它能给您带来启发,令你精通运行并运维该天性是何等的回顾!即便您没领会过 Service Worker,笔者建议你看看此 Github repo,掌握越来越多相关的新闻。

在本案例开头前,让我们先简单地拜会它的劳作流程:

  1. 在顾客第一遍访谈大家的页面时,我们会安装 ServiceWorker,并向浏览器的缓存增添大家的离线 HTML 页面
  2. 下一场,若是客户计划导航到另一个 web 页面(同三个网站下),但此刻已断网,那么大家将回来已被缓存的离线 HTML 页面
  3. 而是,假如顾客筹算导航到别的一个 web 页面,而此时互联网已连接,则能照常浏览页面

Service Worker入门

2015/03/26 · JavaScript · Service Worker

原稿出处: Matt Gaunt   译文出处:[w3ctech

  • 十年踪迹]()   

原生App具有Web应用平常所不具备的富离线体验,按期的沉默更新,新闻布告推送等成效。而新的Serviceworkers规范让在Web App上全体那个职能成为恐怕。

1. 什么是Service Worker

Service Worker是谷歌(Google)倡导的贯彻PWA(Progressive Web App)的一个最重重要剧中人物色,PWA是为着缓和守旧Web APP的欠缺:

(1)未有桌面入口

(2)无法离线使用

(3)没有Push推送

这Service Worker的具体展现是何等的啊?如下图所示:

澳门金莎娱乐网站 2

ServiceWorker是在后台运营的一条服务Worker线程,上海教室小编开了三个标签页,所以体现了八个Client,不过不管开多少个页面都唯有八个Worker在担负处理。那几个Worker的做事是把某个财富缓存起来,然后拦截页面包车型大巴呼吁,先看下缓存Curry有未有,若是局地话就从缓存里取,响应200,反之未有的话就走通常的央浼。具体来讲,ServiceWorker结合Web App Manifest能不辱义务以下专门的学业(那也是PWA的检查测量检验正式):

澳门金莎娱乐网站 3

总结能够离线使用、断网时回来200、能唤醒客商把网址增多贰个Logo到桌面上等。

第一步:使用HTTPS

渐进式Web应用程序需求采用HTTPS连接。尽管应用HTTPS会令你服务器的支付变多,但采取HTTPS能够让您的网址变得更安全,HTTPS网址在Google上的排行也会更靠前。

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

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

让大家伊始吧

固然你有以下 HTML 页面。那固然充裕基础,但能给你完全思路。

XHTML

<!DOCTYPE html>

1
<!DOCTYPE html>

紧接着,让我们在页面里登记 Service Worker,这里仅创立了该指标。向正要的 HTML 里增添以下代码。

JavaScript

<script> // Register the service worker // 注册 service worker if ('serviceWorker' in navigator) { navigator.serviceWorker.register('/service-worker.js').then(function(registration) { // Registration was successful // 注册成功 console.log('ServiceWorker registration successful with scope: ', registration.scope); }).catch(function(err) { // registration failed :( // 注册失败 :( console.log('ServiceWorker registration failed: ', err); }); } </script>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<script>
// Register the service worker
// 注册 service worker
if ('serviceWorker' in navigator) {
    navigator.serviceWorker.register('/service-worker.js').then(function(registration) {
    // Registration was successful
    // 注册成功
    console.log('ServiceWorker registration successful with scope: ', registration.scope);
}).catch(function(err) {
    // registration failed :(
    // 注册失败 :(
    console.log('ServiceWorker registration failed: ', err);
   });
}
</script>

下一场,大家须要成立 Service Worker 文件并将其命名字为‘service-worker.js‘。我们希图用那几个 Service Worker 拦截任何网络伏乞,以此检查网络的连接性,并依照检查结果向顾客再次回到最切合的剧情。

JavaScript

'use strict'; var cacheVersion = 1; var currentCache = { offline: 'offline-cache' + cacheVersion }; const offlineUrl = 'offline-page.html'; this.addEventListener('install', event => { event.waitUntil( caches.open(currentCache.offline).then(function(cache) { return cache.addAll([ './img/offline.svg', offlineUrl ]); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
'use strict';
 
var cacheVersion = 1;
var currentCache = {
  offline: 'offline-cache' + cacheVersion
};
const offlineUrl = 'offline-page.html';
 
this.addEventListener('install', event => {
  event.waitUntil(
    caches.open(currentCache.offline).then(function(cache) {
      return cache.addAll([
          './img/offline.svg',
          offlineUrl
      ]);
    })
  );
});

在位置的代码中,我们在设置 Service Worker 时,向缓存加多了离线页面。如果大家将代码分为几小块,可观望前几行代码中,作者为离线页面钦赐了缓存版本和U昂科威L。若是你的缓存有区别版本,那么您只需立异版本号就可以简单地扫除缓存。在大约在第 12 行代码,我向这么些离线页面及其财富(如:图片)发出央求。在获取成功的响应后,我们将离线页面和有关能源丰富到缓存。

目前,离线页面已存进缓存了,大家可在急需的时等候检查索它。在同贰个 ServiceWorker 中,大家须要对无互连网时回来的离线页面增添相应的逻辑代码。

JavaScript

this.add伊芙ntListener('fetch', event => { // request.mode = navigate isn't supported in all browsers // request.mode = naivgate 并未收获全数浏览器的辅助 // so include a check for Accept: text/html header. // 由此对 header 的 Accept:text/html 举行查证 if (event.request.mode === 'navigate' || (event.request.method === 'GET' && event.request.headers.get('accept').includes('text/html'))) { event.respondWith( fetch(event.request.url).catch(error => { // Return the offline page // 重临离线页面 return caches.match(offlineUrl); }) ); } else{ // Respond with everything else if we can // 再次回到任何大家能回到的东西 event.respondWith(caches.match(event.request) .then(function (response) { return response || fetch(event.request); }) ); } });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
this.addEventListener('fetch', event => {
  // request.mode = navigate isn't supported in all browsers
  // request.mode = naivgate 并没有得到所有浏览器的支持
  // so include a check for Accept: text/html header.
  // 因此对 header 的 Accept:text/html 进行核实
  if (event.request.mode === 'navigate' || (event.request.method === 'GET' && event.request.headers.get('accept').includes('text/html'))) {
        event.respondWith(
          fetch(event.request.url).catch(error => {
              // Return the offline page
              // 返回离线页面
              return caches.match(offlineUrl);
          })
    );
  }
  else{
        // Respond with everything else if we can
        // 返回任何我们能返回的东西
        event.respondWith(caches.match(event.request)
                        .then(function (response) {
                        return response || fetch(event.request);
                    })
            );
      }
});

为了测量检验该意义,你能够选拔 Chrome 内置的开垦者工具。首先,导航到你的页面,然后一旦设置上了 瑟维斯Worker,就展开 Network 标签并将节流(throttling)改为 Offline。(译者注:若将节流设置为 Offline 没意义,则可因此关闭互连网也许经过360河池警卫禁止 Chrome 访谈网络)

澳门金莎娱乐网站 4

假定您刷新页面,你应有能观望相应的离线页面!

澳门金莎娱乐网站 5

比方您只想大致地测量试验该功效而不想写任何代码,那么你能够访问作者已开立好的 demo。其余,上述任何代码能够在 Github repo 找到。

本身晓得用在此案例中的页面很轻易,但您的离线页面则决议于你自身!假使你想深刻该案例的开始和结果,你可以为离线页面加多缓存破坏( cache busting),如: 此案例。

Service Worker 是什么?

三个 service worker 是一段运维在浏览器后台进程里的脚本,它独自于当下页面,提供了那二个无需与web页面交互的成效在网页背后悄悄试行的手艺。在今后,基于它可以兑现音信推送,静默更新以及地理围栏等劳务,但是当前它首先要享有的作用是阻碍和拍卖互连网伏乞,包蕴可编制程序的响应缓存管理。

何以说那一个API是二个老大棒的API呢?因为它使得开辟者能够支撑非常好的离线体验,它赋予开荒者完全调控离线数据的技术。

在service worker建议在此之前,另外一个提供开荒者离线体验的API叫做App Cache。不过App Cache有个别局限性,举个例子它能够很轻巧地化解单页应用的主题材料,但是在多页应用上会很麻烦,而Serviceworkers的产出正是为了减轻App Cache的痛点。

上面详细说一下service worker有怎么样须要专心的地方:

  • 它是JavaScript Worker,所以它不能够从来操作DOM。不过service worker能够透过postMessage与页面之间通讯,把音信布告给页面,假若必要的话,让页面本人去操作DOM。
  • Serviceworker是叁个可编程的网络代理,允许开垦者调控页面上管理的网络必要。
  • 在不被使用的时候,它会自身终止,而当它再也被用到的时候,会被另行激活,所以你不能够依赖于service worker的onfecth和onmessage的管理函数中的全局状态。若是你想要保存一些持久化的新闻,你可以在service worker里使用IndexedDB API。
  • Serviceworker大批量使用promise,所以一旦您不精通哪些是promise,那您供给先读书这篇文章。

2. Service Worker的辅助情形

Service Worker前段时间独有Chrome/Firfox/Opera帮助:

澳门金莎娱乐网站 6

Safari和Edge也在准备扶助Service Worker,由于ServiceWorker是Google主旨的一项规范,对于生态相比密闭的Safari来讲也是迫于时势伊始筹算支持了,在Safari TP版本,能够看来:

澳门金莎娱乐网站 7

在施行功用(Experimental Features)里早已有ServiceWorker的菜单项了,只是尽管张开也是不可能用,会唤醒您还并未有完毕:

澳门金莎娱乐网站 8

但不论如何,起码表明Safari已经希图援救ServiceWorker了。别的还是能够见到在二〇一七年前年10月宣告的Safari 11.0.1本子现已支撑WebRTC了,所以Safari仍旧一个前行的子女。

Edge也希图补助,所以Service Worker的前景特别美好。

第二步:创设一个应用程序清单(Manifest)

应用程序清单提供了和日前渐进式Web应用的相干新闻,如:

  • 应用程序名
  • 描述
  • 富有图片(包蕴主显示器Logo,运转显示屏页面和用的图形恐怕网页上用的图形)

实质上讲,程序清单是页面上用到的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" : "72x72", "type" : "image/png" }, { "src" : "/images/logo/logo152.png", "sizes" : "152x152", "type" : "image/png" }, { "src" : "/images/logo/logo192.png", "sizes" : "192x192", "type" : "image/png" }, { "src" : "/images/logo/logo256.png", "sizes" : "256x256", "type" : "image/png" }, { "src" : "/images/logo/logo512.png", "sizes" : "512x512", "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"         : "72x72",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo152.png",
      "sizes"         : "152x152",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo192.png",
      "sizes"         : "192x192",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo256.png",
      "sizes"         : "256x256",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo512.png",
      "sizes"         : "512x512",
      "type"          : "image/png"
    }
  ]
}

程序清单文件创立完事后,你要求在每一种页面上援引该文件:

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

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

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

  • name: 客商看见的应用名称
  • short_name: 应用短名称。当展现应用名称的地点相当不够时,将利用该名称。
  • description: 选用描述。
  • start_url: 利用起头路线,相对路线,默以为/。
  • scope: U奥迪Q3L范围。举例:要是您将“/app/”设置为U奥迪Q7L范围时,那个动用就能够直接在那么些目录中。
  • 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控件集)或许browser(最古老的利用浏览器标签显示)
  • icons: 一个富含全部图片的数组。该数组中种种成分包罗了图片的UPRADOL,大小和类型。

扩充阅读

别的,还有多少个很棒的离线功效案例。如:Guardian 构建了叁个颇有 crossword puzzle(填字游戏)的离线 web 页面 – 由此,就算等待互联网重连时(即已在离线状态下),也能找到一点野趣。作者也引用看看 Google Chrome Github repo,它含有了广大不一的 瑟维斯 Worker 案例 – 个中有的用到案例也在那!

而是,假若您想跳过上述代码,只是想大致地经过三个库来拍卖相关操作,那么自身引入您看看 UpUp。那是叁个轻量的剧本,能令你更自在地应用离线成效。

打赏帮助笔者翻译更加的多好作品,感激!

打赏译者

Service Worker的生命周期

Service worker具备二个完全独立于Web页面包车型客车生命周期。

要让贰个service worker在您的网址上生效,你需求先在你的网页中注册它。注册三个service worker之后,浏览器会在后台默默运行一个service worker的安装进程。

在设置进度中,浏览器会加载并缓存一些静态财富。假设持有的公文被缓存成功,service worker就安装成功了。假诺有别的文件加载或缓存失利,那么安装进程就能够停业,service worker就无法被激活(也即未能安装成功)。如若发生如此的难点,别担忧,它会在下一次再品尝安装。

当安装完毕后,service worker的下一步是激活,在这一品级,你仍可以升官三个service worker的版本,具体内容大家会在前边讲到。

在激活之后,service worker将接管全体在本身管辖域范围内的页面,不过即便二个页面是刚刚注册了service worker,那么它那叁遍不会被接管,到下壹回加载页面的时候,service worker才会生效。

当service worker接管了页面之后,它大概有二种情景:要么被甘休以节约内部存款和储蓄器,要么会管理fetch和message事件,那七个事件分别发生于二个网络需要出现依旧页面上发送了二个音讯。

下图是叁个简化了的service worker初次安装的生命周期:

澳门金莎娱乐网站 9

3. 使用Service Worker

ServiceWorker的施用套路是首先登场记三个Worker,然后后台就能够运维一条线程,能够在这条线程运营的时候去加载一些能源缓存起来,然后监听fetch事件,在那些事件里拦截页面包车型的士需要,先看下缓存里有未有,假诺有一直回到,不然平时加载。或然是一同始不缓存,每一个财富央求后再拷贝一份缓存起来,然后下一遍呼吁的时候缓存里就有了。

其三步:创造三个 Service Worker

入门教程澳门金莎娱乐网站:,离线网页应用。Service Worker 是二个可编制程序的服务器代理,它可以阻挡大概响应互连网央求。Service Worker 是投身应用程序根目录的二个个的JavaScript文件。

你须要在页面前蒙受应的JavaScript文件中登记该ServiceWorker:

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。

打赏援救自个儿翻译越来越多好文章,感激!

任选一种支付格局

澳门金莎娱乐网站 10 澳门金莎娱乐网站 11

1 赞 3 收藏 1 评论

在我们开端写码从前

从这个类型地址拿到chaches polyfill。

这个polyfill支持CacheStorate.match,Cache.add和Cache.addAll,而现在Chrome M40实现的Cache API还不曾帮衬那个点子。

将dist/serviceworker-cache-polyfill.js放到你的网址中,在service worker中通过importScripts加载进来。被service worker加载的本子文件会被活动缓存。

JavaScript

importScripts('serviceworker-cache-polyfill.js');

1
importScripts('serviceworker-cache-polyfill.js');

需要HTTPS

在开荒阶段,你能够由此localhost使用service worker,可是要是上线,就要求你的server帮忙HTTPS。

您能够经过service worker胁制连接,伪造和过滤响应,特别逆天。尽管你能够约束自个儿不干坏事,也可能有人想干坏事。所认为了避防外人使坏,你不得不在HTTPS的网页上注册service workers,那样我们才足以幸免加载service worker的时候不被歹徒篡改。(因为service worker权限异常的大,所以要谨防它本身被混蛋篡改利用——译者注)

Github Pages赶巧是HTTPS的,所以它是五个佳绩的自然实验田。

设若您想要让您的server帮助HTTPS,你要求为你的server获得三个TLS证书。分化的server安装方法不一致,阅读辅助文档并因此Mozilla’s SSL config generator摸底最好实行。

(1)注册多个Service Worker

瑟维斯 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就能够接管页面包车型大巴富有财富了。

Install事件

该事件将要动用设置到位后触发。咱们日常在此间运用Cache API缓存一些必得的文本。

先是,我们需求提供如下配置

  1. 缓存名称(CACHE)以及版本(version)。应用能够有多个缓存存款和储蓄,可是在利用时只会选拔当中多少个缓存存款和储蓄。每当缓存存款和储蓄有生成时,新的版本号将会钦赐到缓存存款和储蓄中。新的缓存存储将会作为当下的缓存存款和储蓄,在此以前的缓存存款和储蓄将会被作废。
  2. 三个离线的页面地址(offlineUENCOREL):当客商访谈了前面并未有访谈过的地点时,该页面将会显示。
  3. 一个暗含了装有必得文件的数组,包罗保持页面符合规律功能的CSS和JavaScript。在本示例中,作者还增添了主页和logo。当有两样的U奥迪Q5L指向同四个财富时,你也足以将这么些U奥迪Q7L分别写到那些数组中。offlineU宝马X5L将会加盟到那个数组中。
  4. 咱俩也足以将一些非须要的缓存文件(installFilesDesirable)。那么些文件在装置进度中校会被下载,但假诺下载战败,不会接触安装战败。

// 配置文件 const version = '1.0.0', CACHE = version + '::PWAsite', offlineUENVISIONL = '/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())
  );
});

有关我:刘健超-J.c

澳门金莎娱乐网站 12

前端,在路上... 个人主页 · 小编的篇章 · 19 ·     

澳门金莎娱乐网站 13

使用Service Worker

明天大家有了polyfill,并且解决了HTTPS,让大家看看究竟怎么用service worker。

(2)瑟维斯 Worker安装和激活

注册完之后,ServiceWorker就能够开展安装,那个时候会触发install事件,在install事件之中能够缓存一些能源,如下sw-3.js:

JavaScript

const CACHE_NAME = "fed-cache"; this.addEventListener("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调整台所示:

澳门金莎娱乐网站 14

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");
});

ServiceWorker激活之后就可见监听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();

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" view博克斯="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文件。别的央求将会再次回到offlineUOdysseyL 页面。

Chrome开垦者工具中的ServiceWorker部分提供了有关当前页面worker的新闻。个中会来得worker中发出的谬误,还足以强制刷新,也能够让浏览器步向离线方式。

Cache Storage 部分例举了眼下具备曾经缓存的能源。你可以在缓存须求立异的时候点击refresh开关。

什么注册和安装service worker

要安装service worker,你要求在您的页面上注册它。这些手续告诉浏览器你的service worker脚本在哪里。

JavaScript

if ('serviceWorker' in navigator) { navigator.serviceWorker.register('/sw.js').then(function(registration) { // Registration was successful console.log('ServiceWorker registration successful with scope: ', registration.scope); }).catch(function(err) { // registration failed :( console.log('ServiceWorker registration failed: ', err); }); }

1
2
3
4
5
6
7
8
9
if ('serviceWorker' in navigator) {
  navigator.serviceWorker.register('/sw.js').then(function(registration) {
    // Registration was successful
    console.log('ServiceWorker registration successful with scope: ',    registration.scope);
  }).catch(function(err) {
    // registration failed :(
    console.log('ServiceWorker registration failed: ', err);
  });
}

地点的代码检查service worker API是还是不是可用,假诺可用,service worker /sw.js 被注册。

借使这些service worker已经被注册过,浏览器会自行忽略上面的代码。

有二个亟待特别表明的是service worker文件的路径,你显著留神到了在这些事例中,service worker文件被放在这么些域的根目录下,那表示service worker和网址同源。换句话说,那些service work将会接收那几个域下的有所fetch事件。假使自个儿将service worker文件注册为/example/sw.js,那么,service worker只能收到/example/路径下的fetch事件(例如: /example/page1/, /example/page2/)。

今昔你能够到 chrome://inspect/#service-workers 检查service worker是否对你的网站启用了。

澳门金莎娱乐网站 15

当service worker第一版被达成的时候,你也得以在chrome://serviceworker-internals中查看,它很有用,通过它可以最直观地熟悉service worker的生命周期,不过这个功能很快就会被移到chrome://inspect/#service-workers中。

你会意识这几个效果能够很方便地在多个效仿窗口中测量试验你的service worker,那样你能够关闭和另行张开它,而不会耳濡目染到您的新窗口。任何创制在模仿窗口中的注册服务和缓存在窗口被关门时都将断线纸鸢。

(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都同样才是同样的财富,可以设定第1个参数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,借使跨域的能源支持CO凯雷德S,那么可以把request的mod改成cors。假诺须要失利了,如404要么是过期等等的,那么也直接重回response让主页面管理,不然的话表达加载成功,把这些response克隆贰个置于cache里面,然后再回到response给主页面线程。注意能放慢存里的财富平常只可以是GET,通过POST获取的是不可能缓存的,所以要做个判定(当然你也能够手动把request对象的method改成get),还会有把一些民用不期待缓存的能源也做个推断。

那般只要顾客张开过二回页面,ServiceWorker就安装好了,他刷新页面可能张开第三个页面包车型客车时候就能够把诉求的财富一一做缓存,包罗图片、CSS、JS等,只要缓存里有了不管顾客在线也许离线都能够寻常访谈。那样我们本来会有贰个难题,那一个缓存空间到底有多大?上一篇我们提到Manifest也究竟地点存储,PC端的Chrome是5Mb,其实那个说法在新本子的Chrome已经不可信赖了,在Chrome 61本子能够观望地点存款和储蓄的半空竹秋运用状态:

澳门金莎娱乐网站 16

当中Cache Storage是指ServiceWorker和Manifest占用的空间尺寸和,上海体育场面能够见到总的空间尺寸是20GB,大致是unlimited,所以基本上不用担忧缓存会缺乏用。

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

离线页面能够是静态的HTML,日常用来提示顾客近年来恳请的页面权且无法运用。不过,我们得以提供一些方可翻阅的页面链接。

Cache API能够在main.js中央银行使。然则,该API使用Promise,在不帮衬Promise的浏览器中会退步,全数的JavaScript试行会为此受到震慑。为了幸免这种景观,在拜谒/js/offlinepage.js的时候大家增加了一段代码来检查当前是或不是在离线意况中:

/js/offlinepage.js 中以版本号为名称保存了近些日子的缓存,获取具备U锐界L,删除不是页面的U奇骏L,将这么些U猎豹CS6L排序然后将具备缓存的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);
          });
      })
  });

Service Worker的装置步骤

在页面上产生注册手续之后,让咱们把集中力转到service worker的剧本里来,在这在那之中,大家要完毕它的装置步骤。

在最宗旨的例子中,你要求为install事件定义叁个callback,并操纵怎样文件你想要缓存。

JavaScript

// The files we want to cache var urlsToCache = [ '/', '/styles/main.css', '/script/main.js' ]; // Set the callback for the install step self.addEventListener('install', function(event) { // Perform install steps });

1
2
3
4
5
6
7
8
9
10
11
// The files we want to cache
var urlsToCache = [
  '/',
  '/styles/main.css',
  '/script/main.js'
];
 
// Set the callback for the install step
self.addEventListener('install', function(event) {
    // Perform install steps
});

在大家的install callback中,我们需求试行以下步骤:

  1. 开启多个缓存
  2. 缓存大家的文本
  3. 垄断是否具备的能源是或不是要被缓存

JavaScript

var CACHE_NAME = 'my-site-cache-v1'; var urlsToCache = [ '/', '/styles/main.css', '/script/main.js' ]; self.addEventListener('install', function(event) { // Perform install steps event.waitUntil( caches.open(CACHE_NAME) .then(function(cache) { console.log('Opened cache'); return cache.addAll(urlsToCache); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
var CACHE_NAME = 'my-site-cache-v1';
var urlsToCache = [
  '/',
  '/styles/main.css',
  '/script/main.js'
];
 
self.addEventListener('install', function(event) {
  // Perform install steps
  event.waitUntil(
    caches.open(CACHE_NAME)
      .then(function(cache) {
        console.log('Opened cache');
        return cache.addAll(urlsToCache);
      })
  );
});

上边的代码中,大家经过caches.open张开大家内定的cache文件名,然后大家调用cache.addAll并传播大家的公文数组。那是因此多元promise(caches.open 和 cache.addAll)完毕的。event.waitUntil得到三个promise并使用它来收获安装开销的时间以及是或不是安装成功。

只要具有的文件都被缓存成功了,那么service worker就设置成功了。如若其余贰个文书下载战败,那么安装步骤就能破产。这一个点子允许你依附于你和煦钦命的具有能源,不过那意味你须求非常严厉地垄断如何文件要求在安装步骤中被缓存。钦命了太多的文件的话,就能够加多设置战败率。

地方只是二个简易的事例,你能够在install事件中施行别的操作依然以至忽视install事件。

(4)cache html

地点第(3)步把图纸、js、css缓存起来了,不过只要把页面html也缓存了,举个例子把首页缓存了,就能够有三个两难的标题——ServiceWorker是在页面注册的,可是现在赢得页面的时候是从缓存取的,每一回都以同样的,所以就导致无法立异ServiceWorker,如产生sw-5.js,可是PWA又供给大家能缓存页面html。那咋做呢?Google的开辟者文书档案它只是提到会存在这一个主题材料,但并不曾阐明怎么消除那么些标题。这一个的问题的减轻就要求大家要有四个编写制定能精通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。客商公布完商量后会触发刷新页面,刷新的时候缓存已经被删了就能够另行去央浼了。

如此就消除了实时更新的主题材料。

开采者工具

Chrome浏览器提供了一多元的工具来赞助你来调整瑟维斯Worker,日志也会一向呈现在调整台上。

你最棒使用匿超级模特式来举行付出工作,那样能够祛除缓存对开辟的困扰。

最后,Chrome的Lighthouse扩充也足感觉您的渐进式Web应用提供部分革新音讯。

如何缓存和重临Request

你已经设置了service worker,你以后得以回来您缓存的央浼了。

当service worker被安装成功还要客商浏览了另二个页面或许刷新了脚下的页面,service worker将起来接到到fetch事件。上边是二个例证:

JavaScript

self.addEventListener('fetch', function(event) { event.respondWith( caches.match(event.request) .then(function(response) { // Cache hit - return response if (response) { return response; } return fetch(event.request); } ) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
self.addEventListener('fetch', function(event) {
  event.respondWith(
    caches.match(event.request)
      .then(function(response) {
        // Cache hit - return response
        if (response) {
          return response;
        }
 
        return fetch(event.request);
      }
    )
  );
});

地方的代码里我们定义了fetch事件,在event.respondWith里,大家传入了三个由caches.match发生的promise.caches.match 查找request中被service worker缓存命中的response。

即使大家有三个命中的response,大家回去被缓存的值,不然大家回到二个实时从网络央求fetch的结果。那是一个极其轻松的事例,使用全数在install步骤下被缓存的能源。

假设大家想要增量地缓存新的伸手,大家能够透过拍卖fetch诉求的response而且拉长它们到缓存中来兑现,比方:

JavaScript

self.addEventListener('fetch', function(event) { event.respondWith( caches.match(event.request) .then(function(response) { // Cache hit - return response if (response) { return response; } // IMPORTANT: Clone the request. A request is a stream and // can only be consumed once. Since we are consuming this // once by cache and once by the browser for fetch, we need // to clone the response var fetchRequest = event.request.clone(); return fetch(fetchRequest).then( function(response) { // Check if we received a valid response if(!response || response.status !== 200 || response.type !== 'basic') { return response; } // IMPORTANT: Clone the response. A response is a stream // and because we want the browser to consume the response // as well as the cache consuming the response, we need // to clone it so we have 2 stream. var responseToCache = response.clone(); caches.open(CACHE_NAME) .then(function(cache) { cache.put(event.request, responseToCache); }); return response; } ); }) ); });

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
self.addEventListener('fetch', function(event) {
  event.respondWith(
    caches.match(event.request)
      .then(function(response) {
        // Cache hit - return response
        if (response) {
          return response;
        }
 
        // IMPORTANT: Clone the request. A request is a stream and
        // can only be consumed once. Since we are consuming this
        // once by cache and once by the browser for fetch, we need
        // to clone the response
        var fetchRequest = event.request.clone();
 
        return fetch(fetchRequest).then(
          function(response) {
            // Check if we received a valid response
            if(!response || response.status !== 200 || response.type !== 'basic') {
              return response;
            }
 
            // IMPORTANT: Clone the response. A response is a stream
            // and because we want the browser to consume the response
            // as well as the cache consuming the response, we need
            // to clone it so we have 2 stream.
            var responseToCache = response.clone();
 
            caches.open(CACHE_NAME)
              .then(function(cache) {
                cache.put(event.request, responseToCache);
              });
 
            return response;
          }
        );
      })
    );
});

代码里大家所做思想政治工作包含:

  1. 丰硕贰个callback到fetch乞求的 .then 方法中
  2. 比如大家赢得了一个response,大家开展如下的检讨:
    1. 保证response是有效的
    2. 反省response的情状是不是是200
    3. 保证response的品类是basic,那象征央浼笔者是同源的,非同源(即跨域)的呼吁也不能够被缓存。
  3. 假若大家由此了自己讨论,clone其一须求。这么做的缘故是一旦response是四个Stream,那么它的body只好被读取三回,所以大家得将它克隆出来,一份发给浏览器,一份发给缓存。

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 提姆e也许会回来304 Not Modified,不然寻常再次来到200和数码内容。那便是整三个赢得的历程。

故此若是既用了Manifest又用ServiceWorker的话应该会促成同一个能源存了三遍。可是足以让帮助ServiceWorker的浏览器采纳Service Worker,而不协助的施用Manifest.

澳门金莎娱乐网站 ,渐进式Web应用的要点

渐进式Web应用是一种新的技巧,所以使用的时候自然要小心。也便是说,渐进式Web应用能够让您的网址在多少个时辰内得到立异,并且在不扶助渐进式Web应用的浏览器上也不会潜移默化网址的体现。

而是大家须求思虑以下几点:

何以创新一个Service Worker

你的service worker总有供给更新的那一天。当那一天光降的时候,你必要依照如下步骤来更新:

  1. 履新您的service worker的JavaScript文件
    1. 当客户浏览你的网址,浏览器尝试在后台下载service worker的台本文件。只要服务器上的文本和当半夏件有贰个字节区别,它们就被决断为需求立异。
  2. 更新后的service worker将起来运营,install event被重新触发。
  3. 在那个日子节点上,当前页面生效的照样是老版本的service worker,新的servicer worker将踏向”waiting”状态。
  4. 方今页面被关门之后,老的service worker进度被杀死,新的servicer worker正式生效。
  5. 借使新的service worker生效,它的activate事件被触发。

代码更新后,平常需求在activate的callback中施行贰个管制cache的操作。因为你会必要排除掉在此以前旧的多少。大家在activate实际不是install的时候实践这几个操作是因为如果我们在install的时候马上试行它,那么依然在运作的旧版本的数目就坏了。

此前大家只使用了一个缓存,叫做my-site-cache-v1,其实我们也可以使用多个缓存的,例如一个给页面使用,一个给blog的内容提交使用。这意味着,在install步骤里,我们可以创建两个缓存,pages-cache-v1和blog-posts-cache-v1,在activite步骤里,我们可以删除旧的my-site-cache-v1。

下边包车型地铁代码能够循环全体的缓存,删除掉全数不在白名单中的缓存。

JavaScript

self.addEventListener('activate', function(event) { var cacheWhitelist = ['pages-cache-v1', 'blog-posts-cache-v1']; event.waitUntil( caches.keys().then(function(cacheNames) { return Promise.all( cacheNames.map(function(cacheName) { if (cacheWhitelist.indexOf(cacheName) === -1) { return caches.delete(cacheName); } }) ); }) ); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
self.addEventListener('activate', function(event) {
 
  var cacheWhitelist = ['pages-cache-v1', 'blog-posts-cache-v1'];
 
  event.waitUntil(
    caches.keys().then(function(cacheNames) {
      return Promise.all(
        cacheNames.map(function(cacheName) {
          if (cacheWhitelist.indexOf(cacheName) === -1) {
            return caches.delete(cacheName);
          }
        })
      );
    })
  );
});

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": "48x48" }, { "src": "/html/app-manifest/logo_96.png", "type": "image/png", "sizes": "96x96" }, { "src": "/html/app-manifest/logo_192.png", "type": "image/png", "sizes": "192x192" }, { "src": "/html/app-manifest/logo_512.png", "type": "image/png", "sizes": "512x512" } ], "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": "48x48"
    },
    {
      "src": "/html/app-manifest/logo_96.png",
      "type": "image/png",
      "sizes": "96x96"
    },
    {
      "src": "/html/app-manifest/logo_192.png",
      "type": "image/png",
      "sizes": "192x192"
    },
    {
      "src": "/html/app-manifest/logo_512.png",
      "type": "image/png",
      "sizes": "512x512"
    }
  ],
  "start_url": "/?launcher=true",
  "display": "standalone",
  "background_color": "#287fc5",
  "theme_color": "#fff"
}

icon要求图谋七种标准,最大供给512px * 512px的,那样Chrome会自动去采用合适的图样。如若把display改成standalone,从变化的图标展开就能够像展开一个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缓存:
澳门金莎娱乐网站 17把start_url指向的页面用ServiceWorker缓存起来,那样当客商用Chrome浏览器张开那一个网页的时候,Chrome就能在尾巴部分弹三个升迁,询问客商是不是把那几个网页加多到桌面,假使点“加多”就能调换一个桌面Logo,从这几个Logo点进去如同展开八个App一样。感受如下:

澳门金莎娱乐网站 18

比较狼狈的是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 收藏 评论

澳门金莎娱乐网站 19

URL隐藏

当您的应用正是八个单UEvoqueL的应用程序时(比方游戏),我建议你遮蔽地址栏。除了这么些之外的情事作者并不提议你遮盖地址栏。在Manifest中,display: minimal-ui 或者 display: browser对此绝大好多情景来讲丰盛用了。

拍卖边界和填坑

这一节内容比较新,有不菲待定细节。希望这一节极快就不供给讲了(因为标准会管理那些标题——译者注),然而现在,这个剧情依然应当被提一下。

缓存过大

你无法将您网址中的全体剧情缓存下来。对于小片段的网址来讲缓存全部内容并不是多个难题,不过只要一个网址包罗了上千个页面吗?很明显不是全数人对网站中的全部剧情都感兴趣。存款和储蓄是有限定的,如若你将兼具访谈过的页面都缓存下来的话,缓存大小会增进额相当的慢。

你能够如此制订你的缓存计谋:

  • 只缓存主要的页面,举例主页,联系人页面和这段日子浏览作品的页面。
  • 绝不缓存任何图片,录像和大文件
  • 定期清理旧的缓存
  • 提供一个“离线阅读”开关,那样客户就足以挑选须求缓存哪些内容了。

举个例子设置退步了,没有很崇高的方法获得通报

若果一个worker被登记了,然而尚未出现在chrome://inspect/#service-workers或chrome://serviceworker-internals,那么很可能因为异常而安装失败了,或者是产生了一个被拒绝的的promise给event.waitUtil。

要消除那类难题,首先到 chrome://serviceworker-internals检查。打开开发者工具窗口准备调试,然后在你的install event代码中添加debugger;语句。这样,通过断点调试你更容易找到问题。

缓存刷新

示范代码中在倡导呼吁以前会先查询缓存。当顾客处于离线状态时,那很好,然而一旦客户处于在线状态,这他只会浏览到相比较老旧的页面。

各个财富比方图片和摄像不会退换,所以日常都把那个静态财富设置为长远缓存。这一个能源能够直接缓存一年(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

您也足以在历次网址发表时,通过更名的办法强制浏览珍视新需要财富。

fetch()近期仅帮助Service Workers

fetch立刻扶助在页面上使用了,但是方今的Chrome完结,它还只援助service worker。cache API也将在在页面上被扶助,然则方今截至,cache也还只能在service worker中用。

小结

现今,相信您假如根据本文一步一步操作下来,你也足以急迅把温馨的Web应用转为PWA。在转为了PWA后,假设有使用满足PWA 模型的前端控件的须求,你能够试试纯前端表格控件SpreadJS,适用于 .NET、Java 和移动端等楼台的报表控件一定不会令你失望的。

原稿链接:

1 赞 1 收藏 评论

澳门金莎娱乐网站 20

fetch()的暗中同意参数

当你采纳fetch,缺省级地区级,恳求不会带上cookies等凭证,要想带上的话,须要:

JavaScript

fetch(url, { credentials: 'include' })

1
2
3
fetch(url, {
  credentials: 'include'
})

这么设计是有理由的,它比XH奥迪Q5的在同源下暗许发送凭据,但跨域时屏弃凭据的法规要来得好。fetch的表现更像其余的CO昂科雷S诉求,举例<img crossorigin>,它默认不发送cookies,除非你指定了<img crossorigin="use-credentials">.。

Non-COENCORES默许不协理

暗中同意情状下,从第三方U路虎极光L跨域得到三个能源将会退步,除非对方援助了COEscortS。你能够加上一个non-COXC60S选项到Request去幸免退步。代价是那样做会重返一个“不透明”的response,意味着你不可能查出那一个央浼终归是水到渠成了或然战败了。

JavaScript

cache.addAll(urlsToPrefetch.map(function(urlToPrefetch) { return new Request(urlToPrefetch, { mode: 'no-cors' }); })).then(function() { console.log('All resources have been fetched and cached.'); });

1
2
3
4
5
cache.addAll(urlsToPrefetch.map(function(urlToPrefetch) {
  return new Request(urlToPrefetch, { mode: 'no-cors' });
})).then(function() {
  console.log('All resources have been fetched and cached.');
});

fetch()不坚守30x重定向标准

噩运,重定向在fetch()中不会被触发,那是近期版本的bug;

拍卖响应式图片

img的srcset属性恐怕<picture>标签会根据情况从浏览器或者网络上选择最合适尺寸的图片。

在service worker中,你想要在install步骤缓存一个图片,你有以下二种选拔:

  1. 设置具备的<picture>元素或者将被请求的srcset属性。
  2. 设置单一的low-res版本图片
  3. 设置单一的high-res版本图片

相比好的方案是2或3,因为只要把装有的图纸都给下载下来存着有一点点浪费内部存款和储蓄器。

借令你将low-res版本在install的时候缓存了,然后在页面加载的时候你想要尝试从网络上下载high-res的本子,可是尽管high-res版本下载失败以来,就依然用low-res版本。这几个主张很好也值得去做,可是有一个标题:

即使大家有下边三种图片:

Screen Density Width Height
1x 400 400
2x 800 800

HTML代码如下:

JavaScript

<img src="image-src.png" srcset="image-src.png 1x, image-2x.png 2x" />

1
<img src="image-src.png" srcset="image-src.png 1x, image-2x.png 2x" />

即便大家在一个2x的显得方式下,浏览器会下载image-2x.png,假若大家离线,你能够读取在此以前缓存并回到image-src.png替代,要是在此以前它已经被缓存过。即使如此,由于未来的情势是2x,浏览器会把400X400的图样显示成200X200,要防止这一个难题将要要图纸的体裁上设置宽高。

JavaScript

<img src="image-src.png" srcset="image-src.png 1x, image-2x.png 2x" style="width:400px; height: 400px;" />

1
2
<img src="image-src.png" srcset="image-src.png 1x, image-2x.png 2x"
style="width:400px; height: 400px;" />

澳门金莎娱乐网站 21

<picture>标签情况更复杂一些,难度取决于你是如何创建和使用的,但是可以通过与srcset类似的思路去解决。

改变URL Hash的Bug

在M40版本中留存二个bug,它会让页面在更换hash的时候变成service worker甘休职业。

您能够在此间找到越来越多相关的音讯: 

更加的多内容

此地有一部分唇齿相依的文书档案能够参照:

取得救助

只要你碰着麻烦,请在Stackoverflow上发帖询问,使用‘service-worker’标签,以便于大家登时跟进和不择花招援救您化解难题。

赞 2 收藏 评论

澳门金莎娱乐网站 22

本文由澳门金莎娱乐网站发布于澳门金莎娱乐网站,转载请注明出处:入门教程澳门金莎娱乐网站:,离线网页应用

关键词:

浅谈前端工程化,浅谈前端澳门金莎娱乐网站:

下降央浼量 ① 开启GZip ② 优化静态财富,jQuery-Zepto、阉割IScroll、去除冗余代码 ③ 图片无损压缩 ④ 图片延迟加载...

详细>>

图片上传插件ImgUploadJS,拖拽异步上传实现

属性 result :读取到的文件内容,当读取操作完成后生效 readyState :FileReader对象的当前状态 error :出错时的错误信...

详细>>

手势解锁,HTML5实现屏幕手势解锁

HTML5贯彻显示器手势解锁 2015/07/18 · HTML5 · 1评论 ·手势解锁 原著出处:AlloyTeam    成效展现 贯彻原理  利用HTML5的...

详细>>

最近学习JS的感悟,组件化的Web王国

自定义标签在IE6-8的困境 2015/07/20 · HTML5 ·IE,自定义标签 原文出处:司徒正美    或许未来前端组件化之路都是自定...

详细>>