offline-plugin service-worker webpack插件使用記錄

基本知識普及請參考
https://www.jianshu.com/p/623...
https://zhuanlan.zhihu.com/p/...

下面簡單介紹一下插件的使用
如下是我在項目中使用的配置
webpack.prod.conf.js中

{
   ...
    plugins: [
        new OfflinePlugin({
          responseStrategy: 'cache-first', // 緩存優先
          AppCache: false,                 // 不啓用appCache
          safeToUseOptionalCaches: true,   // Removes warning for about `additional` section usage
          autoUpdate: true,                // 自動更新
          caches: {                        // webpack打包後須要換的文件正則匹配
            main: [
              '**/*.js',
              '**/*.css',
              /\.(png|jpe?g|gif|svg)(\?.*)?$/,
              /\.(woff2?|eot|ttf|otf)(\?.*)?$/
              ],
            additional: [
              ':externals:'
            ]
          },
          externals: [],                    // 設置外部連接，例如配置http://hello.com/getuser，那麼在請求這個接口的時候就會進行接口緩存
          excludes: ['**/.*', '**/*.map', '**/*.gz', '**/manifest-last.json'], // 須要過濾的文件
          ServiceWorker: {
            output: './static/sw.js',       // 輸出目錄
            publicPath: '/static/sw.js',    // sw.js 加載路徑
            scope: '/',                     // 做用域（此處有坑）
            minify: true,                   // 開啓壓縮
            events: true                    // 當sw狀態改變時候發射對應事件
          }
        })
    ]
}

在入口js文件中

OfflinePluginRuntime.install({
    // 監聽sw事件，當更新ready的時候，調用applyUpdate以跳過等待，新的sw當即接替老的sw
  onUpdateReady: () => {
    console.log('SW Event:', 'onUpdateReady')
    OfflinePluginRuntime.applyUpdate()
  },
  onUpdated: () => {
    console.log('SW Event:', 'onUpdated')
    window.swUpdate = true
  }
})

首先介紹一下assets裏面的三個屬性:
main: [] 這裏配置的是serviceWorker在install階段須要緩存的文件清單，若是其中有一個失敗了，那麼整個serviceWorder就會安裝失敗，因此必須謹慎配置

additional: [] 這裏配置的文件清單會在serviceWorker activate的時候進行緩存，與main不同，若是這裏的文件緩存失敗，不會影響serviceWorker的正常安裝。並且，在接下來頁面的ajax異步請求中，還能進行緩存嘗試

optional: [] 這裏配置的文件清單在serviceWorker安裝激活階段不會進行緩存，只有在監聽到網絡請求的時候才進行緩存。

剛纔說到做用域的時候有坑，若是按照上面的文件配置，最後在網頁中會提示，sw最大的做用域權限在/static下面，言外之意這麼寫是沒法將sw的做用域設置在/根路徑下面。
因此這邊須要服務端在返回sw.js的時候手動設置Service-Worker-Allowed頭字段，而且值設置爲/，同時這個文件的緩存時間設爲0，不然，當更新serviceWorker的時候，因爲瀏覽器緩存了sw.js用戶端這邊的serviceWorker沒法第一時間更新。

最後來一張線上項目，在網速極慢的狀況下也能實現秒開

-------------------追加--------------------擴展fetch事件
首先在配置文件裏添加入口

sw-entry.js

self.addEventListener('fetch', function (event) {
  function cachesMatch (request, cacheName) {
    return caches.match(request, {
      cacheName: cacheName
    }).then(function (response) {
      return response
    })
    // Return void if error happened (cache not found)
    ['catch'](function () {})
  }
  function cacheFirst(cacheUrl, CACHE_NAME) {
    var resource = cachesMatch(cacheUrl, CACHE_NAME).then(function (response) {
      if (response) {
        return response;
      }
      // Load and cache known assets
      var fetching = fetch(urlString).then(function (response) {
        if (!response.ok) {
          return response;
        }
        (function () {
          var responseClone = response.clone();
          var storing = caches.open(CACHE_NAME).then(function (cache) {
            return cache.put(urlString, responseClone);
          }).then(function () {
            console.log('[SW]:', 'Cache asset: ' + urlString);
          });
          event.waitUntil(storing);
        })();

        return response;
      });

      return fetching;
    })
    return resource
  }
  function netWorkFirst(cacheUrl, CACHE_NAME) {
    var resource = fetch(cacheUrl).then(response => {
      if (response.ok) {
        var responseClone = response.clone()
        var storing = caches.open(CACHE_NAME).then(function (cache) {
          cache.put(cacheUrl, responseClone);
        }).then(function () {
          console.log('[SW]:', 'Cache asset: ' + cacheUrl);
        });
        event.waitUntil(storing);
        return response;
      }
      // Throw to reach the code in the catch below
      throw new Error('Response is not ok');
    })
    ['catch'](function () {
      return cachesMatch(cacheUrl, CACHE_NAME);
    });
    return resource
  }

  var url = new URL(event.request.url)
  url.hash = ''
  var pathname = url.pathname
  var urlString = url.toString()
  var cacheUrl = urlString
  var IS_KANO = /kano\.guahao\.cn/
  var IS_STATIC = /\/static\//
  var IS_HOME = /^\/(e|u|n)\/(\d+)$/
  var IS_EDITOR = /^\/editor(?!\.)/
  var IS_PREVIEW = /^\/preview(?!\.)/
  var CACHE_PREFIX = __wpo.name
  var CACHE_TAG = __wpo.version
  var CACHE_NAME = CACHE_PREFIX + ':' + CACHE_TAG
  var resource = undefined
  var isGET = event.request.method === 'GET'
  // 以緩存優先的形式緩存 kano 以及 static/* 靜態資源
  if ((cacheUrl.match(IS_KANO) || pathname.match(IS_STATIC)) && isGET) {
    resource = cacheFirst(cacheUrl, CACHE_NAME)
    event.respondWith(resource)
  }
  // 以網絡優先的形式緩存 editor頁面 preview頁面和 production頁面
  if ((pathname.match(IS_HOME) || pathname.match(IS_EDITOR) || pathname.match(IS_PREVIEW)) && isGET) {
    resource = netWorkFirst(cacheUrl, CACHE_NAME)
    event.respondWith(resource)
  }
})