Chrome 40 で今すぐ ServiceWorker を試す

Chrome では、リリース 40 からごく一部で「マシな AppCache」とも言われている [ServiceWorker](http://html5experts.jp/iwase/7006/) がデフォルトで使えるようになります。ServiceWorker はオフライン API の1つとして紹介されていることが多いですが、実は **「Webの世界観を変える** (かもしれない) **大注目API」**の1つです！

ここでは、Chrome 40 で出来たての ServiceWorker をひと通り試す方法を書いてみたいと思います。

# ServiceWorker とは?

詳しいことは[最新スペック (Editor's Draft)](https://slightlyoff.github.io/ServiceWorker/spec/service_worker/index.html)や[HTML5Rocks の記事](http://www.html5rocks.com/en/tutorials/service-worker/introduction/)を見てもらうとして、ものすごくざっくり書くと ServiceWorker とはバックグラウンドで実行される Javascript 環境のことで、 **ブラウザ内で動くJavascriptで書いたネットワークプロキシ** のように動作させることができます。

ブラウザの Javascript 環境というとページの UI 部分を書くものというイメージが強いですが、ServiceWorker からページの DOM をいじるようなことはできません。その代わり、ServiceWorker は次のような強力な機能を備えています：

* ServiceWorker に紐付けられたページのネットワーク要求を横取りして代わりにデータを返すことができる
* Offline cache のためのプログラマブルな Cache API を持つ
* 紐付けられたWebページと PostMessage で通信することで、協調して動作することができる
* **将来的に Push メッセージング、バックグラウンド同期、ジオフェンシング (位置認識)などの機能が取り込まれることが予定されている（！）**

AppCache の代わりにプログラマブルに offline cache を扱うことができる、という点がよくフィーチャーされていますが、それに限らずバックグラウンドで様々なことを行うための土台として発展していくことが期待されています。

ServiceWorker で使えるようになる (予定の) 機能はどれも低レイヤかつ実に強力なものばかりで、 ServiceWorker の登場により「Web」が指す世界はこれから大きく変わっていくのではないかと考えられています。

# 今すぐ ServiceWorker を試す

Chrome 40 は 2014 年 12 月現在 Beta まで来ていますので、Beta, Dev あるいは Canary がインストールされていれば、何もしなくても**誰でも今すぐに** ServiceWorker を試すことが可能です！ Beta や Dev 版の Chrome を使っていない場合、[Chrome Canary](https://www.google.com/chrome/browser/canary.html)を使うのがおそらくもっとも簡単でしょう。

自分の Chrome が ServiceWorker をサポートしているか知るには、[chrome://version](chrome://version) からバージョンが 40 以上であることを確認してみてください。

## HTTPS を準備する (localhost 以外で試す場合)

ServiceWorker は大変強力な API なので、セキュリティのために HTTPS 必須となっており、localhost で試す場合以外は HTTPS のセットアップをする必要があります。例えば Github Pages は HTTPS でサーブされるので、デモなどのページであれば Github Pages で作ってしまうのが簡単かもしれません。

以降では localhost でとにかく試す方法を書いています。

## 最も単純なサンプルを試す

ServiceWorker のサンプルコードは、例えば https://github.com/GoogleChrome/samples から取ってくることができます。[samples/service-worker](https://github.com/GoogleChrome/samples/tree/gh-pages/service-worker)にいろいろな基本パターンのサンプルが置かれています。

試しに一番単純なサンプルを Chrome 40 で動かしてみましょう。

```bash:Terminal
$ git clone https://github.com/GoogleChrome/samples.git GoogleChromeSamples
$ cd GoogleChromeSamples/service-worker
$ python -m SimpleHTTPServer
```

このようにしたあと、Chrome で `http://localhost:8000/basic` を開くと、次のようなページが開きます:

> ![sw1.png](https://qiita-image-store.s3.amazonaws.com/0/2758/590b8b78-e119-e923-22b3-a5a430d226fc.png "sw1.png")

リンクが2つ貼られているので、試しに "world" というリンクを辿ってみましょう。"world" は `hello/world` というページにリンクされていますが、`basic` ディレクトリ以下にそんなページは存在しないので 404 Not Found のエラーページが返されます…… 変ですね？

ここでおもむろに上の方にある **`Register` ボタンを押してからもう一度 "world" リンクを辿ってみます**。すると次のような表示に変わります：

> ![sw2.png](https://qiita-image-store.s3.amazonaws.com/0/2758/e4eb67ae-935b-7981-4713-8c6a7b1682f3.png "sw2.png")

存在しないはずのページが表示されました！ 実はこのページのデータは Web サーバが返したものではなく、`Register` によってブラウザに登録された ServiceWorker が返しています。この ServiceWorker は動的にページを生成するので、実は http://localhost:8000/basic/hello/hoge など、'hello/' の後ろに任意のパスを指定しても動きます。

# "basic"サンプルがやっていること

ここで、この basic サンプルが何をやっているのか少しだけ見てみましょう。[basic/index.html](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/basic/index.html)の中を見ると、`Register`ボタンが押されると次のようなコードが走るようになっています：

```javascript:index.html
...
var scope = 'hello/';
...
function register() {
  navigator.serviceWorker.register('service-worker.js', {scope: scope})
    .then(function(r) {
      console.log('registered: ');
      registration = r;
      console.log(registration);
    })
    .catch(function(whut) {
      console.error('uh oh... ');
      console.error(whut);
    });
}
...
```

このコードでは、`navigator.serviceWorker.register()` メソッドを使って [service-worker.js](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/basic/service-worker.js)を ServiceWorker として登録(インストール)しています。(`register` メソッドは[Promises](http://www.html5rocks.com/ja/tutorials/es6/promises/)を返します)

この ServiceWorker は、scope として指定されている `hello/` 以下の URL に対して動作するように登録されます。

# 登録されている ServiceWorker を調べる

ここで、Chrome 上で実際に登録されている ServiceWorker を見てみましょう。現在登録されている ServiceWorker は **[chrome://serviceworker-internals](chrome://serviceworker-internals)** から調べることができます：

> ![sw-internal.png](https://qiita-image-store.s3.amazonaws.com/0/2758/25167899-5534-c389-bdef-6467b10e6ef6.png "sw-internal.png")

ここで、http://localhost:8000/basic/hello/ 以下の URL スコープに対し、[http://localhost:8000/basic/service-worker.js](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/basic/service-worker.js) という ServiceWorker が実際に登録されていることが確認できます。このページで ServiceWorker が `console.log()` で出力したログも見ることが出来ます。

# ServiceWorker を DevTools で開く

次に、実際に登録されている ServiceWorker の中身を見てみましょう。[chrome://serviceworker-internals](chrome://serviceworker-internals) ページの `Inspect` ボタンをクリックすると、登録されている ServiceWorker のスクリプトをデバッグするための DevTools ウィンドウが開かれます。

> ![sw-inspect.png](https://qiita-image-store.s3.amazonaws.com/0/2758/58656cd8-3d44-807d-cc9d-970f6e32c57f.png "sw-inspect.png")

`Sources`タブでスクリプトの中身を見てみると、中身は小さな `onfetch` というイベントハンドラだけなことがわかります。その中で、リクエストの URL が hello/<i>hoge</i> のような文字列だったら "Hello, *hoge*!" という文字列を作り、それを [Blob](https://developer.mozilla.org/ja/docs/DOM/Blob) として動的にレスポンスを生成して返しています。

```js:service-worker.js
self.onfetch = function(event) {
  console.log('got a request');

  ...

  var body = new Blob([salutation, whom, energy_level, version]);
  event.respondWith(new Response(body));
};
```

ここで、`onfetch` はスコープ内の URL に対してネットワークリクエストが出されたときに呼び出されるイベントハンドラです。ここで渡される `FetchEvent` の `.respondWith()` というメソッドを使って任意のレスポンスを返すことができます。

# オフラインで ServiceWorker を動作させる

一度登録された ServiceWorker は、そのあとオフラインになっても登録されたスコープに対してアクセスがあると呼び出されるようになります。試しにローカルの HTTP サーバを止めてみましょう：

```bash:Terminal
$ python -m SimpleHTTPServer
^C

```

ここで http://localhost:8000/basic をアクセスし直すと、「このページにアクセスできない」というエラーが表示されるはずです。

一方、ServiceWorker が登録されている `hello/` 以下の URL、例えば http://localhost:8000/basic/hello/offline にアクセスすると、ServiceWorker によって "Hello, offline!" というページが表示されるはずです。

# ServiceWorker スクリプトを更新する

ServiceWorker は一度登録されればオフラインでも動作することはわかりましたが、スクリプトを更新したい場合はどうすればいいのでしょう？

答えはシンプルで、ServiceWorker が登録されているスコープ内の URL に対するアクセスがあると、ブラウザ (Chrome) は自動的に更新をチェックしてくれます。ただし、複数バージョンの ServiceWorker が同時に動いておかしな状態にならないよう、前のバージョンのスクリプトを使って表示されているページがいずれかのタブで開かれている限り、古いスクリプトが動作し続けます。

ここで、 **タブを開いたままリロードするだけでは ServiceWorker スクリプトは置き換わらない**ことに注意して下さい。ブラウザは現在のページをアンロードする前に次のネットワークリクエストを出すため、古いスクリプトが動作し続けてしまうのです。新しいスクリプトを使うには、 **一旦タブを閉じて開き直す** 必要があります。

(なお、リロード無しで新しい ServiceWorker を使えるようにするための [skipWaiting()](https://slightlyoff.github.io/ServiceWorker/spec/service_worker/#service-worker-global-scope-skipwaiting) という新しいメソッドが提案されており、[Chrome でもじきに使えるようになる予定です](https://groups.google.com/a/chromium.org/d/msg/blink-dev/IEMjiDBuMRk/3_2yH0mR744J))。

試しに `service-worker.js` を書き換えてみましょう。例えば次のように "Hello" を "こんにちは"、"Version 1" を "Version 2" に書き換えて保存し、http://localhost:8000/basic/hello/world を開いたタブをリロードしてみます。

```javascript:service-worker.js
...
  var salutation = 'こんにちは、';
  var whom = decodeURIComponent(event.request.url.match(/\/([^/]*)$/)[1]);
  var energy_level = (whom == 'Cleveland')
      ? '!!!' // take it up to 11
      : '!';
  var version = '\n\n(Version 2)';
...

```

リロードしても変わらず "Hello, world! (Version 1)" と表示され続けるはずです。(ここで[chrome://serviceworker-internals](chrome://serviceworker-internals)をチェックすると、"Status: INSTALLED" と書かれた ServiceWorker がもう一つ登録されていることが確認できます)

新しいスクリプトを使うために、タブを一度閉じてからまた http://localhost:8000/basic/hello/world にアクセスしてみましょう。すると今度はちゃんと "こんにちは、world! (Version 2)" と表示されるはずです。

# Fetch と Cache API を使う

Chrome 40 では、XHR (XMLHttpRequest) をより包括的かつ低レイヤから置き換える[Fetch API](http://jxck.hatenablog.com/entry/whatwg-fetch)も ServiceWorker から使えるようになっています。ここでは、Fetch と Cache API を使ってオフラインでも動作する Web サイトを作ってみます。

## Cache API のポリフィルを準備する

Chrome 40 では Cache.add(), Cache.addAll(), Cache.match() など、Cache API のいくつかの機能がまだ実装されていません。これらの機能を使うには、Cache API のポリフィル (https://github.com/coonsta/cache-polyfill) を使う必要があります。

ポリフィルを使うには、[dist/serviceworker-cache-polyfill.js](https://github.com/coonsta/cache-polyfill/blob/master/dist/serviceworker-cache-polyfill.js)を取ってきて、ServiceWorker スクリプトの中で import します：

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

なお、[Cache.match はもうじき(おそらく Chrome 41 で)ポリフィルなしでも使えるようになる予定](https://groups.google.com/a/chromium.org/d/msg/blink-dev/mIbjEvBrmnU/CVKFb5HIU1sJ)です。

## Cache API を使ったオフライン対応サイト

ここからは実際にシンプルなオフライン対応サイトを作ってみます。次のような index.html, page.js, main.css, offline_icon.png の 4 つのファイルから成る静的な Web サイトを作ります。

```index.html
<!DOCTYPE html>
<head>
  <link rel='stylesheet' type='text/css' href='main.css'>
  <link rel='stylesheet' type='text/css' href='http://fonts.googleapis.com/css?family=Special+Elite'>
</head>
<body>
  <h1>Service Worker sample</h1>
  <p>ServiceWorker を使ってページをキャッシュするサンプルです。</p>
  <p id="log"></p>
  <script type='text/javascript' src='page.js'></script>
</body>
```
```javascript:page.js
function log(msg) {
  document.querySelector('#log').textContent = msg;
}

navigator.serviceWorker.register('./service-worker.js', {scope:'./'})
  .then(function(sw) {
      if (navigator.serviceWorker.controller) {
        log('このページは ServiceWorker にコントロールされています');
      } else {
        log('ServiceWorker が登録されました');
      }
    })
  .catch(function(err) {
    log('ServiceWorker の登録に失敗しました: ' + err);
  });
```

```main.css
h1:after { content: url('offline_icon.png'); }
h1 { font-size: 36px; }
* { font-family: 'Special Elite'; }
```

`offline_icon.png` は HTML5 Offline Storage のアイコンを使うことにします：![offline_icon.png](https://qiita-image-store.s3.amazonaws.com/0/2758/f568f264-3df2-20cf-7adb-3a9785db4d3d.png "offline_icon.png")

このページをコントロールする ServiceWorker のためのスクリプトを service-worker.js に準備します。

```javascript:service-worker.js
importScripts('serviceworker-cache-polyfill.js');

// インストール時 (register時) に静的ファイルをキャッシュしておく
self.oninstall = function(event) {
  // .waitUntil() に渡された Promises が resolve されたら
  // インストール完了
  event.waitUntil(
    caches.open('statics-v1').then(function(cache) {
      return cache.addAll([
        '/',
        '/page.js',
        '/offline_icon.png',
        '/main.css']);
    })
  );
};

// ページヘのネットワークリクエストが来たらキャッシュにある
// データを返す
self.onfetch = function(event) {
  event.respondWith(caches.match(event.request));
};
```

この ServiceWorker スクリプトでは、`importScripts()` で Cache API のポリフィルを import し、ServiceWorker のインストール時に呼び出される `oninstall` イベントハンドラでこのサイトを構成するすべての静的ファイルをキャッシュに入れています。

また、ページへのネットワークリクエストが来たら呼び出される `onfetch` イベントハンドラでは、サーバに取りに行く代わりにキャッシュにあるデータを返します。

全ファイルと Cache API のポリフィルを `sample` というディレクトリにおいて、このディレクトリをルートとして http サーバを走らせてみましょう。

```bash:Terminal
$ ls sample/
index.html			service-worker.js
main.css			serviceworker-cache-polyfill.js
offline_icon.png

$ python -m SimpleHTTPServer
```

このあと http://localhost:8000/ を Chrome 40 で開くと、次のように表示されるはずです：

> ![sw-sample1.png](https://qiita-image-store.s3.amazonaws.com/0/2758/c6097b74-4977-130f-d345-44a37c199006.png "sw-sample1.png")


*"ServiceWorker が登録されました"* というメッセージは、`navigator.serviceWorker.register()`による ServiceWorker のインストールが完了したあとに表示されます。`service-worker.js` の `oninstall` ハンドル内のキャッシュの初期化が終わらないとインストールは完了しないので、メッセージが出るまで数秒かかることがあります。

ここでもう一度リロードすると、今度は表示が次のように変わります。

> ![sw-sample2.png](https://qiita-image-store.s3.amazonaws.com/0/2758/b1356220-55c3-9f8d-3946-4e2d9400a146.png "sw-sample2.png")

*"このページは ServiceWorker にコントロールされています"* というメッセージは、ServiceWorker が無事にインストールされ、index.html へのネットワークリクエストが　ServiceWorker によって処理されていることを示しています。

この ServiceWorker の `onfetch` イベントハンドラはキャッシュにあるデータを返すだけの単純なものなので、このサイトはこのままオフラインでも動作します。ただし、`oninstall` でキャッシュに入れなかった Web フォントのデータは返すことができないため、見ての通りリロード後は Web フォントが使われていません。

## Cache API と Fetch を組み合わせる

キャッシュに入っていないデータがリクエストされたときにはネットワークにデータを取りに行くように `service-worker.js` を書き換えてみましょう。書き換え後の `onfetch` ハンドラは次のようになります：

```javascript:service-worker.js
self.onfetch = function(event) {
  event.respondWith(
    caches.match(event.request).then(function(response) {
      return response || fetch(event.request);
    })
  );
};
```

Promises に慣れてないと読みにくいですが、キャッシュからリクエストにマッチするデータを探し、もしなかったら `fetch()` を呼び出してネットワークからデータを取得しています。

新しい ServiceWorker を使うために、ページをリロードしてから一度閉じて開くと、今度は(オンラインであれば) Web フォントを使ったページが表示されるはずです。

> ![sw-sample3.png](https://qiita-image-store.s3.amazonaws.com/0/2758/baee5d6d-6711-de63-f2df-d14d633be88b.png "sw-sample3.png")

ネットワークから取ってきたレスポンスをさらにキャッシュしたければ、さらに次のような感じに書けます。

```js:service-worker.js
self.onfetch = function(event) {
  event.respondWith(
    caches.open('statics-v1').then(function(cache) {
      return cache.match(event.request).then(function(response) {
        console.log(event.request.url, response);
        if (response)
          return response;
        fetch(event.request.clone()).then(function(response) {
          if (response.status < 400) {
            // HTTP response code がエラーじゃないときだけ fetch が返した
            // レスポンス(のコピー)をキャッシュする。
            // (ただし、non-CORS リクエストについてはレスポンスは filtered
            // opaque response となり、.status は常に 0 にセットされるため、
            // エラーレスポンスをキャッシュしてしまう可能性はある
            // https://fetch.spec.whatwg.org/#concept-filtered-response-opaque)
            cache.put(event.request, response.clone());
          }
          return response;
        });
      })
    })
  );
};
```

これで、一度 Web フォントが取ってこられたら次からはそれもキャッシュに入ることになります。

ただし、コード中のコメントにもあるように、この方法では non-CORS で異なるオリジンからのレスポンスをすべてキャッシュしてしまうので、エラーレスポンスをキャッシュしてしまう可能性があります。(逆に言うと、non-CORS リクエストのレスポンスはエラーとほとんど見分けがつきません)

## コード一式

ここで使ったオフライン対応サイトのコード一式はこちらから取得できます：

https://github.com/kinu/ServiceWorkerOfflineBasic

# オフライン挙動のさまざまなパターン

オフライン時の挙動をどのように ServiceWorker で書くかについては、Jake さんの [Offline cookbook](http://jakearchibald.com/2014/offline-cookbook/) という blog エントリで次のようなさまざまなパターンが紹介されています: 

* [Cache only](http://jakearchibald.com/2014/offline-cookbook/#cache-only): 毎回キャッシュから返す
*  [Network only](http://jakearchibald.com/2014/offline-cookbook/#network-only): 毎回ネットワークに取りに行く
* [Cache, falling back to network](http://jakearchibald.com/2014/offline-cookbook/#cache-falling-back-to-network): キャッシュを見て、なかったらネットワークへ
* [Cache & network race](http://jakearchibald.com/2014/offline-cookbook/#cache-network-race): キャッシュとネットワークに同時にリクエストして速い方を使う
* [Network falling back to cache](http://jakearchibald.com/2014/offline-cookbook/#network-falling-back-to-cache): まずネットワークに取りに行って、失敗したらキャッシュを使う
* [Cache then network](http://jakearchibald.com/2014/offline-cookbook/#cache-then-network): キャッシュとネットワークに同時にリクエストし、先に返されたデータを使う。ネットワークからの返答があればさらにキャッシュも更新する
* [Generic fallback](http://jakearchibald.com/2014/offline-cookbook/#generic-fallback): キャッシュもネットワークもデータを返さなかったらデフォルトの fallback データを返す
* [ServiceWorker-side templating](http://jakearchibald.com/2014/offline-cookbook/#serviceworker-side-templating): ServiceWorker 内でテンプレートエンジンを動かす


各パターンにはそれぞれ長短がありますが、こうしたさまざまな挙動を目的にあわせて Javascript で細かくプログラムできるのが、ServiceWorker のもっとも大きな特徴であり魅力の1つといえます。

みなさんも今日から ServiceWorker で [#offlinefirst](https://twitter.com/intent/tweet?url=http://qiita.com/kinu/items/2abd61b4390f9bbaffc9&text=%E3%81%93%E3%81%AE%E5%86%AC%E4%BC%91%E3%81%BF%E3%81%AFServiceWorker%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%82%AA%E3%83%95%E3%83%A9%E3%82%A4%E3%83%B3%E5%AF%BE%E5%BF%9C%E3%82%B5%E3%82%A4%E3%83%88%E3%82%92%E4%BD%9C%E3%82%8A%E3%81%BE%E3%81%99%EF%BC%81&hashtags=offlinefirst,ServiceWorker) な Web サイトを作ってみませんか？

# 参考にさせてもらったページ

概ね HTML5Rocks と Google の developer advocate である Jake Archibald さんの blog を参考にしてます。

* [HTML5Rocks: Intro to ServiceWorkers](http://www.html5rocks.com/en/tutorials/service-worker/introduction/)
* [Jake Archibald blog: Using ServiceWorker in Chrome today](http://jakearchibald.com/2014/using-serviceworker-today/)
* [Jake Archibald blog: The offline cookbook](http://jakearchibald.com/2014/offline-cookbook/)
* [Is ServiceWorker Ready?](https://jakearchibald.github.io/isserviceworkerready/)

また、[@kenjibaheux](https://twitter.com/kenjibaheux)さん、[@nhiroki_](https://twitter.com/nhiroki_)さんに内容をレビューしてもらいました、どうもありがとうございます！

----
Disclaimer: ここで述べられていることは私の個人的な意見に基づくものであり、私の雇用者には関係ありません。