created_at
updated_at
tags
toc

Service Worker の Navigation Preload による表示遅延回避

Intro

Service Worker で Fetch を Proxy する場合、Fetch 発生時に SW が起動していなければ、その起動を待つ必要が出る。

そして、この SW の起動には無視できない時間がかかる場合があった。

これを改善する Navigation Preload について解説する。

SW Bootup

SW が onfetch をハンドルし、キャッシュから Response を返す場合は、ネットワーク I/O をせずに画面をレンダリングできる。

しかし、SW が onfetch をフックしていてもなお、実際にネットワークにリクエストを投げる場合は少なくない。

この場合、もしページのコントローラとなっている SW が起動していない場合は、onfetch ハンドラを実行するために、SW の起動を待つ必要が出てくる。

SW の起動には、もちろん実行環境によるところが大きいが、50~500ms 程度の時間がかかるとされている。

つまり、せっかく表示を最適化しても、SW を追加することでそれを台無しにしてしまうケースがあるということだ。

これを解決するのが Navigation Preload である。

Navigation Preload を有効にすると、SW が起動してない状態で発生したリクエストを、SW をバイパスしてネットワーク側に送ることができる。

つまり、実際の Fetch の実施と、SW の起動を並行して行うということだ。

しかし、それだけでは、onfetch のハンドラ内でキャッシュ処理などを実行することができない。

そこで、SW が起動した後に、並行して行った Fetch の結果に触ることができるため、後からキャッシュに詰める/ヘッダを追加するといったことが可能になる。

ただし、基本的に問題になるのは、しばらくアクセスしてなかったページに遷移して、最初のページを表示する部分になる。

ここで発生するリクエストは Navigation Request と呼ばれ、ブラウザが生成するものであり、ページ構築中/後に JS から発行される XHR などは含まれていない。

API

onfetch に先立って有効化されている必要があるため、onactivate で有効にする。

self.addEventListener('activate', (e) => {
  if (!self.registration.navigationPreload) {
    console.log("navigationPreload not supported")
  }
  console.log("navigationPreload supported")
  e.waitUntil(self.registration.navigationPreload.enable())
})

無効化は disable() を呼ぶ。

preloadResponse

サーバが返したレスポンスは、SW 起動後に onfetch ハンドラ内で取得できる。

Preload がある場合はそれを返し、なければ実際に fetch を走らせるコードは以下のようになる。

self.addEventListener('fetch', (e) => {
  console.log('url', e.request.url)

  e.respondWith((() => {
    return e.preloadResponse.then((res) => {
      console.info('preload res', res)
      if (res) return res

      console.log('fetch')
      return fetch(e.request)
    });
  })())
})

Service-Worker-Navigation-Preload Header

Preload Response が発生した場合は、リクエストヘッダに以下が追加される。

Service-Worker-Navigation-Preload: true

これにより、サーバ側は Preload リクエストであることを判別できる。

値の true はデフォルト値であり、以下のように任意の値に変更できる。

navigator.serviceWorker.register('worker.js')
  .then((registration) => {
    const ID = btoa(Math.random());
    return registration.navigationPreload.setHeaderValue(ID)
  })

getState()

もし Navigation Preload を有効にした状態で、preloadResponse を確認せずに fetch を実行した場合は、同じリクエストを重複して投げてしまう可能性があるため注意が必要である。

Navigation Preload が有効になっているかは、以下のように取得することができる。

また、同時に前述のヘッダに付与される値も取得が可能だ。

navigator.serviceWorker.register('worker.js')
  .then((registration) => {
    return registration.navigationPreload.getState()
  })
  .then((state) => {
    console.log(state.enabled)
    console.log(state.headerValue)
  })

DEMO

動作するデモを以下に用意した。