1、serviceWorker介绍
service worker是一段运行在浏览器后台的JavaScript脚本,在页面中注册并安装成功后,它可以拦截和处理网络请求,实现缓存资源并可在离线时响应用户的请求。针对弱网及无网络场景,可使用离线资源。特点:
网站必须使用 HTTPS。本地可使用 localhost单独的运行环境和执行线程:在一个新线程中,不会影响js主线程的运行,所以不会造成阻塞。不能访问dom:但service worker可以通过postMessage与页面之间通信生命周期:
installing - 安装事件被触发,但还没完成。缓存静态资源
installed" - 安装完成activating - 激活事件被触发,但还没完成activated - 激活成功 更新资源redundant - 废弃,可能是因为安装失败,或者是被一个新版本覆盖事件:
install: 安装阶段触发,缓存静态资源activate:sw激活时触发,做缓存更新,删除旧资源fetch:拦截与处理网络请求,缓存匹配及缓存策略制定使用实例:
//缓存资源的两种方式://(1)在install事件中,进行静态资源的缓存,自定义要缓存的资源//(2)在fetch事件中,通过service worker的fetch截获网络请求,请求成功后将资源缓存起来。即在网络请求完成后,缓存也完成,不需额外请求。// 要注意一点,/sw.js 文件可能会因为浏览器缓存问题,当文件有了变化时,浏览器里还是旧的文件。这会导致更新得不到响应。如遇到该问题,可尝试这么做:在 Web Server 上添加对该文件的过滤规则,不缓存或设置较短的有效期。//定义缓存的key及缓存列表var cacheStorageKey = 'pwa-sw20180409-2';var cacheWhitelist = ['pwa-sw20180409-2']; //清理缓存,保留whitelist中的缓存,其他的删除var cacheList = [ './main.html', './js/main.js', './css/main.css',];self.addEventListener("install", function(e) { console.log("sw install 事件触发", e); e.waitUntil( //安装成功后 ServiceWorker 状态会从 installing 变为 installed 当 Promise reject 的时候,代表着安装失败,浏览器将这个 SW 废弃掉,不会控制任何 clients。 caches.open(cacheStorageKey) .then(cache => cache.addAll(cacheList)) //cacheList中的文件全部安装完成 加载这些资源并将响应添加至缓存。cache.addAll() 是原子操作,如果某个文件缓存失败了,那么整个缓存就会失败! .then(() => self.skipWaiting()) //self.skipWaiting() 页面更新的过程当中, 新的 Service Worker 脚本能立即激活和生效 跳过等待状态 )});// 如果希望在有了新版本时,所有的页面都得到及时更新,则在安装阶段跳过等待,直接进入 active/*self.addEventListener('install', function(event) { event.waitUntil(self.skipWaiting());});*/self.addEventListener('activate', event => event.waitUntil( Promise.all([ // 更新客户端 self.clients.claim(), //让 clients 受service worker控制 // 清理旧版本 caches.keys().then(cacheList => Promise.all( cacheList.map(cacheName => { console.log("缓存键名", cacheName, cacheWhitelist); /*if (cacheWhitelist.indexOf(cacheName) == -1) { console.log("删除老的缓存", cacheName); caches.delete(cacheName); }*/ }) )).then(function(){ console.log("activate事件回调"); console.log('self.clients',self.clients); // return self.clients.matchAll() return self.clients.matchAll() .then(function(clients) { console.log("客户端clients",clients); if (clients && clients.length) { clients.forEach(function (client) { console.log("客户端client",client); // 这样发出去,sw-register.js 就能收的到啦 client.postMessage('sw.update'); }) } }) }).catch(function(err) { console.log("err", err); }) ])));//更新缓存,清理旧缓存/*self.addEventListener("activate",function(e){ console.log("清理旧缓存"); e.waitUntil( caches.keys().then(function(keyList){ return Promise.all(keyList.map(function(key){ console.log("缓存列表中的key",key); if(cacheWhitelist.indexOf(key)==-1){ console.log("删除key",key); return caches.delete(key); } })); }) )});*///监听资源请求 判断是否从缓存中获取self.addEventListener("fetch", function(e) { console.log("fetch拦截事件", e.request); var startTime = + new Date(); e.respondWith( caches.match(e.request) .then(function(response) { console.log("caches", caches); e.request.cache = false; e.request.headers = {"Cache-Control":"no-cache"}; // console.log("缓存结果", response); // console.log('更新后e.request',e.request); if (response != null) { // // 如果 Service Worker 有自己的返回,就直接返回,减少一次 http 请求 console.log("匹配成功 使用缓存", e.request); var endTime = + new Date(); console.log("使用缓存耗时",endTime-startTime); return response; } console.log("response为null 走网络请求", e.request); // 如果 service worker 没有返回,那就得直接请求真实远程服务 //var request = e.request.clone(); // 把原始请求拷过来 return fetch(e.request).then(function(httpRes) { // fetch(fetchRequest, { credentials: 'include' } ); //fetch请求默认不带cookie,可通过此参数将cookie带过去 var endTime = + new Date(); console.log("走网络请求耗时",endTime-startTime); // 请求失败了,直接返回失败的结果就好了。。 if (!httpRes || httpRes.status !== 200) { return httpRes; } // 请求成功的话,将请求缓存起来。 如果是index.html页面的话 需要考虑更新问题 // var responseClone = httpRes.clone(); // caches.open(cacheStorageKey).then(function (cache) { // cache.put(e.request, responseClone); // }); return httpRes; }).catch(function(e) { console.log("网络请求失败", e); // return fetch(e.request); }) }).catch(function(e) { console.log("匹配失败", e.request); return fetch(e.request); }) )});//监听离线状态/*self.addEventListener('offline', function() { Notification.requestPermission().then(grant => { if (grant !== 'granted') { return; } const notification = new Notification("Hi,网络不给力哟", { body: '您的网络貌似离线了,不过在志文工作室里访问过的页面还可以继续打开~', icon: '//lzw.me/images/avatar/lzwme-80x80.png' }); notification.onclick = function() { notification.close(); }; });});*///错误监控self.onerror = function(errorMessage, scriptURI, lineNumber, columnNumber, error) { if (error) { console.log(error); // reportError(error); } else { console.log(errorMessage, scriptURI, lineNumber, columnNumber, error) // reportError({ // message: errorMessage, // script: scriptURI, // line: lineNumber, // column: columnNumber // }); }}//当 Promise 类型的回调发生reject 却没有 catch 处理,会触发 unhandledrejection 事件。self.addEventListener('unhandledrejection', function(event) { console.log("unhandledrejection", event); // reportError({ // message: event.reason // })});
2、workbox
workbox 是 GoogleChrome 团队推出的一套 Web App 静态资源本地存储的解决方案,该解决方案包含一些 Js 库和构建工具,在 Chrome Submit 2017 上首次隆重面世。而在 workbox 背后则是 Service Worker 和 Cache API 等技术和标准在驱动。配置化:几乎不用考虑太多的具体实现,只用做一些配置。简单却不失灵活,可以完全自定义相关需求(支持 Service Worker 相关的特性如 Web Push, Background sync 等)。支持多种缓存策略:针对各种应用场景的多种缓存策略以及自定义缓存策略(1)基于workbox-build工具生成缓存列表
需要先安装workbox-build,npm install workbox-build --save-dev
根据配置参数提取预缓存的资源文件,注入到预缓存内容列表中,生成一份service worker 文件。
workboxBuild.injectManifest(params)swSrc : 生成 service-worker.js 所需的模板文件所在位置
swDest:生成的 service-worker.js 的存放位置。globDirectory:指定需要预缓存的静态文件的目录。globPatterns:相对于 globDirectory 指定的目录,指出哪些文件需要被预缓存。globIgnores:相对于 globDirectory 指定的目录,指出哪些文件不需要被预缓存。service-worker.js 本身会被自动排除const workboxBuild = require('workbox-build');const path = require("path");const fs = require("fs");workboxBuild.injectManifest({ swSrc: path.join(__dirname, './', 'sw.dev.js'), swDest: path.join(__dirname, './', 'sw.js'), globDirectory: '.\\', globPatterns: ['**\/*.{html,js,css,png,jpeg}' ], globIgnores: ['clear.html',"sw.js", "sw-register.js", "sw.dev.js", "sw-register.dev.js", "build/*.js", "workbox-cli-config.js", "webpack.config.js", "build-sw.js", "Gruntfile.js", "package.json", "batlog.log", 'node_modules/**', "js/lib/**"], templatedUrls: { // '/shell': ['dev/templates/app-shell.html', 'dev/**\/*.css'], }, // 要替换的预留代码区正则 // injectionPointRegexp: /(\.precacheAndRoute\()\s*\[\s*\]\s*(\))/, // workbox.precaching.precacheAndRoute([],{ ignoreUrlParametersMatching:[/v/,/\d+/]}); injectionPointRegexp: /(\.precacheAndRoute\()\s*\[\s*\]\s*(,\{ignoreUrlParametersMatching\:\s*\[\S*\]\s*\}\))/, }).then(function() { console.log("注入预缓存文件列表,sw.js生成"); }) .catch(err => { console.error(`Unable to inject the precache manifest into sw.js`); console.error(err); throw err; });
(2)缓存更新
增量更新:当Service worker文件发生变化时,会重新触发注册,新的sw安装后,会缓存新的sw中的缓存资源列表中发生变化的文件。而每个资源的更新主要依靠每个文件的revision值,根据revision值来判断文件的变化,决定是否更新。
3、需要注意的问题
(1)sw缓存问题: sw文件本身不能被缓存,同时,注册Service worker的载体文件也不能被缓存。SW注册思路:
借助一个js文件(sw-register.js)来注册sw,并且保证这个文件是每次都请求最新的,同时在注册sw时增加版本号管理,每次发布时更新版本号
function insertSWregister(){ console.log("插入sw-register.js"); var script = document.createElement('script'); var firstScript = document.getElementsByTagName('script')[0]; script.type = 'text/javascript'; script.async = true; script.src = './sw-register.js?v=' + Date.now(); firstScript.parentNode.insertBefore(script, firstScript); }
sw-register.js
// var VERSION = '2.04';//window._pasSwVersion;if ('serviceWorker' in navigator) { console.log("支持service worker!!!!!"); // 为了保证首屏渲染性能,可以在页面 load 完之后注册 Service Worker navigator.serviceWorker.getRegistrations().then(function(regs) { console.log("注册的sw list", regs); // delSW(regs,function(){ //删除成功后回调 // window.location.reload(); // }); regSW(); }).catch(function(e) { console.log("getRegistrations出错", e); });} else { console.log("不支持service worker!");}//监听sw更新window.addEventListener('swupdate', e => { // service-worker.js 如果更新成功会 postMessage 给页面,内容为 'sw.update' console.log("sw.update更新完成"); if(confirm("内容发生更新,是否要立即更新?")){ window.location.reload(); }});function regSW() { navigator.serviceWorker.register('./sw.js?v=1523357182344').then(function(reg) { console.log("注册成功,当前作用域为:", reg.scope); reg.onupdatefound = function() { console.log("状态变化",reg); var installingWorker = reg.installing; //安装中的 SW console.log("状态变化installingWorker.state",installingWorker.state); installingWorker.onstatechange = function() { switch (installingWorker.state) { //state; // "installing" - 安装事件被触发,但还没完成 // "installed" - 安装完成 // "activating" - 激活事件被触发,但还没完成 // "activated" - 激活成功 // "redundant" - 废弃,可能是因为安装失败,或者是被一个新版本覆盖 case 'installed': console.log("安装完成installed"); console.log('navigator.serviceWorker.controller:',navigator.serviceWorker.controller); if (navigator.serviceWorker.controller) { //判断当前client是否被serviceworker控制 var event = document.createEvent('Event'); event.initEvent('swupdate', true, true); window.dispatchEvent(event); } break; } }; }; if (reg.installing) { console.log('Service worker installing。。。'); } if (reg.waiting) { console.log('Service worker installed。。。'); } if (reg.active) { console.log('Service worker active。。。'); } }).catch(function(e) { console.log("注册service worker失败", e); })}//删除缓存function delSW(regs,callback) { for (var reg of regs) { console.log("遍历注册的sw", reg); var url= window.location.href; var scope = url.substr(0,url.indexOf("/index.html")+1); if (reg.scope == scope) { reg.unregister().then(function(boolean) { //卸载sw 后,再次请求会直接走网络请求,但是缓存文件并未删除 // if boolean = true, unregister is successful console.log("注销成功 unregister", reg); //清除所有缓存文件 caches.delete("workbox-precache-"+scope).then(function(data) { console.log("删除缓存workbox-precache-"+scope, data); if(typeof callback=="function"){ callback(); } }); }); } }}
(2)缓存匹配为题
我们的文件都带了时间戳,并且入口文件在native中会被自动加上版本号v,而缓存匹配是精确匹配
https://XX/index.html?20180410
https://XX/index.html?v=6.1方案:workbox中支持忽略参数配置项,可以忽略url中的部分参数
ignoreUrlParametersMatching:[/v/,/\d+/] 忽略v参数和随机数参数workbox.precaching.precacheAndRoute([],{ignoreUrlParametersMatching:[/v/,/\d+/]});
(2)浏览器缓存问题:
sw在更新时,如果文件的revision发生变化,则sw会做一次请求,重新请求该文件,但是如果浏览器缓存未失效,则返回的文件内容还是旧的,无法更新。 请求的响应顺序: Service Worker > http cache > 网络请求 针对在更新文件时被浏览器缓存拦截导致的无法更新,workbox中采用设置Request对象上的cache配置项,跳过浏览器缓存。对于不支持cache配置项的使用追加参数的方式避开浏览器缓存。_cacheBustRequest(request) { // let url = request.url+"?"+(+new Date()); let url = request.url; const requestOptions = {}; if ('cache' in Request.prototype) { // Make use of the Request cache mode where we can. // Reload skips the HTTP cache for outgoing requests and updates // the cache with the returned response. requestOptions.cache = 'reload'; requestOptions.headers = myHeaders; } else { const parsedURL = new URL(url, location); // This is done so the minifier can mangle 'global.encodeURIComponent' const _encodeURIComponent = encodeURIComponent; parsedURL.search += (parsedURL.search ? '&' : '') + _encodeURIComponent(`_workbox-cache-bust`) + '=' + _encodeURIComponent(this._revision); url = parsedURL.toString(); } return new Request(url, requestOptions); } }
最终方案:(1)直接在url后面追加时间戳,保证在sw更新文件时,绕过浏览器缓存,从服务器获取最新文件
(2)强制请求服务器,跳过http缓存
var myHeaders = new Headers();myHeaders.append('Cache-Control', 'max-age=0');requestOptions.headers = myHeaders;new Request(url, requestOptions);
4、pwa前后对比
(1)离线可用性:提供离线访问能力
(2)性能:文件加载速度,service worker缓存和浏览器缓存读取差异
使用serviceWorker后,多一个向sw发送请求的耗时