プログレッシブウェブアプリ

どのようなものか

プログレッシブウェブアプリは、英語でProgressive Web
Appとも書き、通常はPWAと略します。ブラウザーからインストールし、専用
アイコンから起動し、専用ウインドウでアプリのように動かせるウェブサイ
トです。通信がなくなっても、一部を使い続けられることが多くあります。
ずっと普通のウェブサイトであることは変わりません。アプリストアから何
かを取得するわけではなく、ページは、ブラウザーがタブ内で読み込むもの
と同じHTML、CSS、JavaScriptです。

この用語を定義する標準はありません。標準が定義しているのは、構成する
二つの部分です。一つ目は、W3CのWeb Application
Manifestが記述するJSONファイル、ウェブアプリマニフェストです。アプリ
の名前、アイコン、開始URL、表示モードを与えます。仕様の条件は広く、
「どのウェブサイトも、インストール可能なウェブアプリケーションであ
る」とします。ブラウザーはインストール手段を提供でき、インストールし
たアプリは、その後マニフェストの設定を適用して開きます。`standalone`
表示モードでは、ネイティブアプリに似せることを目指します。専用ウイン
ドウや、アプリケーションランチャーのアイコンなどを備える場合があり、
URLバーのようなブラウザーの通常の操作部品は表示しません。

二つ目は、W3CのService
Workers仕様にあるサービスワーカーです。ブラウザーがページとは別に動
かすスクリプトで、ページとネットワークの間に入り、ページのリクエスト
を見て、自身が管理するキャッシュから応答できます。これにより、通信が
なくても、ウェブアプリのページを返し続けられます。このキャッシュの管
理者はスクリプトです。仕様では、ブラウザーの通常のHTTPキャッシュと完
全に分け、スクリプトが変更したときだけ変わるものとしています。

Web Application Manifestには「progressive」という語は一度もなく、
Service
Workers仕様には、ChromiumがPWAを認識する方法についての注記に一度だけ
出ます。Next.jsのPWAガイドは、PWA機能の一部に対応しないブラウザーで
も正常に使えるよう、プログレッシブエンハンスメントを勧めています。そ
の意味で、どの部分も必須ではありません。マニフェストを無視するブラウ
ザーでも、サービスワーカーを使えないブラウザーでも、ウェブサイト自体
は表示します。

プログレッシブウェブアプリは、別種のウェブサイトでもありません。単一
ページアプリケーション、静的サイト、サーバーで描画するサイトのどれ
も、マニフェストとサービスワーカーを追加できます。この言葉が表すの
は、HTMLの作り方ではなく、読み込み後にブラウザーがそのサイトをどのよ
うに扱えるかです。

なぜ重要なのか

Next.jsのガイドは、利点を三つ挙げます。アプリストアの審査を待たず、
更新をすぐ配信できること。一つのコードベースがすべてのプラットフォー
ムで使えること。そして、ホーム画面へのインストールやプッシュ通知な
ど、ネイティブアプリに期待される機能を持てることです。いずれも、アプ
リがウェブサイトのままであることから来ています。新しい版は、アプリス
トアで別途リリースせずに公開できます。ただし、各端末が新しい版に切り
替わる時期は、キャッシュとサービスワーカーの更新に左右されます。

サービスワーカーがある理由は、オフラインへの対応です。仕様の動機を述
べる節は、従来のウェブアプリが、ネットワークに到達できることを前提と
してきたため、接続の途切れへの対応では、ほかのアプリ基盤の方が優れて
いると説明します。サービスワーカーは、ウェブアプリにも中断を扱う方法
を与えます。導入すれば、トンネル内の列車や、沿岸の電波が届かない船で
使う際に、ブラウザーのエラーページで終わる必要がなくなります。

二つの部分は独立しています。Next.jsのガイドは、インストールの案内を
出すために、オフライン対応は必要ないと述べます。マニフェスト仕様から
も、`serviceworker`メンバーは削除されました。サービスワーカーなしで
もインストール可能にでき、マニフェストがまったくない普通のサイトで
も、サービスワーカーでオフライン対応にできます。

共通の条件はHTTPSです。Next.jsは、スマートフォンのホーム画面へインス
トールするための二条件として、HTTPSで配信するサイトと、有効なマニ
フェストを挙げます。Service
Workers仕様は、サービスワーカーが安全なコンテキストで動くことを求め
ます。実際にはHTTPSを使い、開発用のlocalhostは例外として認められま
す。

実際の活用例

この記事用に書いた三つの小さなファイルで、動くPWAを作れます。マニ
フェストは、アプリの名前、表示モード、アイコンを指定します。

```json
{
  "name": "Field Notes",
  "short_name": "Notes",
  "start_url": "/",
  "display": "standalone",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}
```

各ページは、マニフェストを参照し、対応するブラウザーでだけサービス
ワーカーを登録します。

```html
<link rel="manifest" href="/manifest.webmanifest" />
<script>
  if ("serviceWorker" in navigator) {
    navigator.serviceWorker.register("/sw.js");
  }
</script>
```

サービスワーカーは、オフライン用に少数のファイルを保存します。

```js
// sw.js
const CACHE = "shell-v2";
const SHELL = ["/offline.html", "/app.css", "/app.js"];

async function precache() {
  const cache = await caches.open(CACHE);
  await cache.addAll(SHELL);
}

async function dropOldCaches() {
  const names = await caches.keys();
  const old = names.filter((name) => name !== CACHE);
  await Promise.all(old.map((name) => caches.delete(name)));
}

async function respond(request) {
  if (request.mode === "navigate") {
    try {
      return await fetch(request);
    } catch {
      return caches.match("/offline.html");
    }
  }
  const hit = await caches.match(request);
  return hit ?? fetch(request);
}

self.addEventListener("install", (event) => {
  event.waitUntil(precache());
});

self.addEventListener("activate", (event) => {
  event.waitUntil(dropOldCaches());
});

self.addEventListener("fetch", (event) => {
  if (event.request.method !== "GET") return;
  event.respondWith(respond(event.request));
});
```

マニフェストの拡張子は、登録されている`.webmanifest`で、メディア型
`application/manifest+json`として配信します。サービスワーカーの既定
の範囲は、スクリプトを置いたディレクトリーなので、ルートに置きます。
`/js/sw.js`なら、管理できるのは`/js/`配下だけです。ただし、サーバー
が`Service-Worker-Allowed`ヘッダーを送れば、その範囲を広げられます。
インストール時に`shell-v2`というキャッシュを開き、オフライン用ペー
ジ、スタイルシート、スクリプトを保存します。どれかのファイルがエラー
の状態コードを返すと、`addAll()`が失敗します。そのPromiseを
`waitUntil()`へ渡しているため、中途半端なキャッシュを残すのではな
く、インストール全体が失敗します。有効化時には、名前が異なるキャッ
シュをすべて消します。ページへの移動は、まずネットワークへ問い合わ
せ、応答がなければ、キャッシュのオフライン用ページへ戻ります。それ以
外は、キャッシュにあればそこから返し、なければ取得します。`GET`以外
のリクエストには介入しません。

実在するプラットフォームにこの仕組みを一式実装した例も、この会社が紹
介しています。ポートフォリオの記録は、必要だった理由を説明します。利
用者の多くは、スマートフォンを使う船員や現場担当者で、電波がないか弱
いことが多いため、ネイティブアプリのようにインストールし、通信が途切
れても使える必要がありました。両方を実装しています。複数サイズのアイ
コン、起動画面、テーマ色を備え、ホーム画面へインストールできます。
サービスワーカーはnext-pwaプラグインで設定し、Workboxの実行時キャッ
シュで、フォント、画像、音声、動画、CDN素材をキャッシュ優先で返し、
HTTPのキャッシュ制御ヘッダーも使います。リクエストごとには、これらの
素材が変わらないためです。サービスワーカーにはHTTPSが必要なので、イ
ンストールとオフライン動作は、実機でHTTPSを通して試しました。記録さ
れた成果は、インストール後にオフラインでも使い続け、再訪時にはキャッ
シュから読み込むアプリです。

インストールの部分は、使う側から見ても違いがあります。このサイトのア
プリとしてインストールする案内は、各ブラウザーでのコマンドの場所を説
明します。iPhoneのSafariなら共有メニューと「ホーム画面に追加」、パソ
コンのChrome、Edge、Brave、Opera、Vivaldiならアドレスバー右側の小さ
なアイコン、macOS
Sonoma以降のSafariなら「Dockに追加」です。iOS自身は、インストールを
提案しないことも記します。Firefoxは、Windowsでは143以降、Microsoft
StoreからFirefoxをインストールした場合は150以降で、ウェブアプリ専用
ウインドウを使えますが、macOSとLinuxでは使えません。また、このサイト
をインストールして得られるのは、アイコンとウインドウであり、オフライ
ン用コピーではない、と明示します。オフライン対応には、サービスワー
カーが必要だからです。

問題が起きるところ

利用者が古い版を使い続けます。 Service
Workers仕様では、作者が明示的に求めない限り、キャッシュオブジェクト
は更新されず、作者が消さない限り期限も切れません。そのため、キャッ
シュ優先のワーカーは、スクリプトが指示を変えるまで、昨日のスタイル
シートを返し続けます。例のように、キャッシュ名にバージョンを入れ、保
存するファイルが変われば名前を変え、有効化時に古いキャッシュを消しま
す。ブラウザーは、新しく取得した`sw.js`を、インストール済みのものと
バイト単位で比べるため、更新のきっかけはスクリプトの変更です。それで
も、新しいワーカーは、`skipWaiting()`を呼ばなければ、古いものを使う
タブやウインドウがなくなるまで待ちます。タブを開き続ける利用者は、そ
の間ずっと古い版を使います。Next.jsのガイドは、ワーカー自身の最新版
を必ず取得できるよう、`sw.js`を`Cache-Control:
no-cache, no-store, must-revalidate`で配信します。

ノートパソコンでは動き、テスト用スマートフォンでは動きません。
`navigator.serviceWorker`が存在するのは、安全なコンテキストだけで
す。暗号化しないHTTPで開いたページでは、通常の機能確認が何も告げずに
偽となり、ワーカーは登録されず、その事実がページに表示されることもあ
りません。仕様では、ブラウザーがlocalhost、127.0.0.0/8、::1/128を開
発用として許可してよいとしています。そのため、開発者自身のマシンで動
くワーカーも、スマートフォンがローカルネットワーク上のそのマシンのア
ドレスへHTTPで接続して、同じアプリを開くと、利用できないことがありま
す。Next.jsには、ローカルでHTTPSを試す`next
dev
i--experimental-https`があります。インストールもオフライン動作も、完		engineer.company	70
i了とする前に、実機とHTTPSで試します。		engineer.company	70

fetchリスナーが何もしません。 Service
Workers仕様は、ChromiumにPWAとして認めさせるためだけに、空の`fetch`
リスナーを登録するサイトがあると記します。仕様は、今では`()
i=>		engineer.company	70
{}`のようなリスナーを検出し、不要なだけでなく性能を損なう可能性もあ
る、とブラウザーが警告することを勧めています。リクエストに応答するハ
ンドラーを書くか、リスナー自体を付けないようにします。

インストール案内が出ることを前提にします。
案内するかどうか、どう案内するかは、ブラウザーが決めます。Next.js
は、有効なマニフェストとHTTPSがあれば、現在のブラウザーは自動で案内
すると説明する一方、`beforeinstallprompt`を使った独自ボタンは勧めま
せん。このイベントは、すべてのブラウザーやプラットフォームで使えるわ
けではなく、iOSのSafariにも対応しないためです。その後、マニフェスト
仕様は、イベント自体を削除しました。表示モードと開始URLも、あくまで
指定側の希望です。`standalone`に非対応なら、`minimal-ui`、その次は普
通のタブである`browser`へ戻ります。Next.jsのiOS向け案内のように、イ
ンストール方法を伝えつつ、タブで開いて使う場合にも対応して設計しま
す。

参考資料

  * Web Application Manifest —
マニフェストの形式、メンバー、表示モード、インストールとアンインス
トールの意味です。

  * Service Workers — ワーカーのライフサイクル、範囲、更新規則、安全
なコンテキストの条件、Cache
APIを扱います。

  * Web Application Manifest：インストール可能なウェブアプリ —
ブラウザーがアプリをインストールし、起動し、利用者が削除できるように
する仕組みです。

  * Service Workers：キャッシュの寿命 —
スクリプトが指示しない限り、キャッシュオブジェクトが更新も失効もしな
い理由です。

  * Next.jsでプログレッシブウェブアプリ（PWA）を作る方法 —
マニフェストファイル、プッシュ通知、iOSのインストール案内、開発中の
HTTPS、サービスワーカーのセキュリティーヘッダーです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/progressive-web-app/	engineer.company	70
