{"canonical_url":"https://engineer.company/ja/glossary/progressive-web-app/","content_markdown":"# プログレッシブウェブアプリ\n\n## どのようなものか\n\nプログレッシブウェブアプリは、英語でProgressive Web Appとも書き、通常はPWAと略します。ブラウザーからインストールし、専用アイコンから起動し、専用ウインドウでアプリのように動かせるウェブサイトです。通信がなくなっても、一部を使い続けられることが多くあります。ずっと普通のウェブサイトであることは変わりません。アプリストアから何かを取得するわけではなく、ページは、ブラウザーがタブ内で読み込むものと同じHTML、CSS、JavaScriptです。\n\nこの用語を定義する標準はありません。標準が定義しているのは、構成する二つの部分です。一つ目は、W3CのWeb Application Manifestが記述するJSONファイル、ウェブアプリマニフェストです。アプリの名前、アイコン、開始URL、表示モードを与えます。仕様の条件は広く、「どのウェブサイトも、インストール可能なウェブアプリケーションである」とします。ブラウザーはインストール手段を提供でき、インストールしたアプリは、その後マニフェストの設定を適用して開きます。`standalone`表示モードでは、ネイティブアプリに似せることを目指します。専用ウインドウや、アプリケーションランチャーのアイコンなどを備える場合があり、URLバーのようなブラウザーの通常の操作部品は表示しません。\n\n二つ目は、W3CのService Workers仕様にあるサービスワーカーです。ブラウザーがページとは別に動かすスクリプトで、ページとネットワークの間に入り、ページのリクエストを見て、自身が管理するキャッシュから応答できます。これにより、通信がなくても、ウェブアプリのページを返し続けられます。このキャッシュの管理者はスクリプトです。仕様では、ブラウザーの通常のHTTPキャッシュと完全に分け、スクリプトが変更したときだけ変わるものとしています。\n\nWeb Application Manifestには「progressive」という語は一度もなく、Service Workers仕様には、ChromiumがPWAを認識する方法についての注記に一度だけ出ます。Next.jsのPWAガイドは、PWA機能の一部に対応しないブラウザーでも正常に使えるよう、プログレッシブエンハンスメントを勧めています。その意味で、どの部分も必須ではありません。マニフェストを無視するブラウザーでも、サービスワーカーを使えないブラウザーでも、ウェブサイト自体は表示します。\n\nプログレッシブウェブアプリは、別種のウェブサイトでもありません。単一ページアプリケーション、静的サイト、サーバーで描画するサイトのどれも、マニフェストとサービスワーカーを追加できます。この言葉が表すのは、HTMLの作り方ではなく、読み込み後にブラウザーがそのサイトをどのように扱えるかです。\n\n## なぜ重要なのか\n\nNext.jsのガイドは、利点を三つ挙げます。アプリストアの審査を待たず、更新をすぐ配信できること。一つのコードベースがすべてのプラットフォームで使えること。そして、ホーム画面へのインストールやプッシュ通知など、ネイティブアプリに期待される機能を持てることです。いずれも、アプリがウェブサイトのままであることから来ています。新しい版は、アプリストアで別途リリースせずに公開できます。ただし、各端末が新しい版に切り替わる時期は、キャッシュとサービスワーカーの更新に左右されます。\n\nサービスワーカーがある理由は、オフラインへの対応です。仕様の動機を述べる節は、従来のウェブアプリが、ネットワークに到達できることを前提としてきたため、接続の途切れへの対応では、ほかのアプリ基盤の方が優れていると説明します。サービスワーカーは、ウェブアプリにも中断を扱う方法を与えます。導入すれば、トンネル内の列車や、沿岸の電波が届かない船で使う際に、ブラウザーのエラーページで終わる必要がなくなります。\n\n二つの部分は独立しています。Next.jsのガイドは、インストールの案内を出すために、オフライン対応は必要ないと述べます。マニフェスト仕様からも、`serviceworker`メンバーは削除されました。サービスワーカーなしでもインストール可能にでき、マニフェストがまったくない普通のサイトでも、サービスワーカーでオフライン対応にできます。\n\n共通の条件はHTTPSです。Next.jsは、スマートフォンのホーム画面へインストールするための二条件として、HTTPSで配信するサイトと、有効なマニフェストを挙げます。Service Workers仕様は、サービスワーカーが安全なコンテキストで動くことを求めます。実際にはHTTPSを使い、開発用のlocalhostは例外として認められます。\n\n## 実際の活用例\n\nこの記事用に書いた三つの小さなファイルで、動くPWAを作れます。マニフェストは、アプリの名前、表示モード、アイコンを指定します。\n\n```json\n{\n  \"name\": \"Field Notes\",\n  \"short_name\": \"Notes\",\n  \"start_url\": \"/\",\n  \"display\": \"standalone\",\n  \"icons\": [\n    { \"src\": \"/icon-192.png\", \"sizes\": \"192x192\", \"type\": \"image/png\" },\n    { \"src\": \"/icon-512.png\", \"sizes\": \"512x512\", \"type\": \"image/png\" }\n  ]\n}\n```\n\n各ページは、マニフェストを参照し、対応するブラウザーでだけサービスワーカーを登録します。\n\n```html\n\u003clink rel=\"manifest\" href=\"/manifest.webmanifest\" /\u003e\n\u003cscript\u003e\n  if (\"serviceWorker\" in navigator) {\n    navigator.serviceWorker.register(\"/sw.js\");\n  }\n\u003c/script\u003e\n```\n\nサービスワーカーは、オフライン用に少数のファイルを保存します。\n\n```js\n// sw.js\nconst CACHE = \"shell-v2\";\nconst SHELL = [\"/offline.html\", \"/app.css\", \"/app.js\"];\n\nasync function precache() {\n  const cache = await caches.open(CACHE);\n  await cache.addAll(SHELL);\n}\n\nasync function dropOldCaches() {\n  const names = await caches.keys();\n  const old = names.filter((name) =\u003e name !== CACHE);\n  await Promise.all(old.map((name) =\u003e caches.delete(name)));\n}\n\nasync function respond(request) {\n  if (request.mode === \"navigate\") {\n    try {\n      return await fetch(request);\n    } catch {\n      return caches.match(\"/offline.html\");\n    }\n  }\n  const hit = await caches.match(request);\n  return hit ?? fetch(request);\n}\n\nself.addEventListener(\"install\", (event) =\u003e {\n  event.waitUntil(precache());\n});\n\nself.addEventListener(\"activate\", (event) =\u003e {\n  event.waitUntil(dropOldCaches());\n});\n\nself.addEventListener(\"fetch\", (event) =\u003e {\n  if (event.request.method !== \"GET\") return;\n  event.respondWith(respond(event.request));\n});\n```\n\nマニフェストの拡張子は、登録されている`.webmanifest`で、メディア型`application/manifest+json`として配信します。サービスワーカーの既定の範囲は、スクリプトを置いたディレクトリーなので、ルートに置きます。`/js/sw.js`なら、管理できるのは`/js/`配下だけです。ただし、サーバーが`Service-Worker-Allowed`ヘッダーを送れば、その範囲を広げられます。インストール時に`shell-v2`というキャッシュを開き、オフライン用ページ、スタイルシート、スクリプトを保存します。どれかのファイルがエラーの状態コードを返すと、`addAll()`が失敗します。そのPromiseを`waitUntil()`へ渡しているため、中途半端なキャッシュを残すのではなく、インストール全体が失敗します。有効化時には、名前が異なるキャッシュをすべて消します。ページへの移動は、まずネットワークへ問い合わせ、応答がなければ、キャッシュのオフライン用ページへ戻ります。それ以外は、キャッシュにあればそこから返し、なければ取得します。`GET`以外のリクエストには介入しません。\n\n実在するプラットフォームにこの仕組みを一式実装した例も、この会社が紹介しています。[ポートフォリオの記録](/ja/portfolio/delivered-full-progressive-web-app-support/)は、必要だった理由を説明します。利用者の多くは、スマートフォンを使う船員や現場担当者で、電波がないか弱いことが多いため、ネイティブアプリのようにインストールし、通信が途切れても使える必要がありました。両方を実装しています。複数サイズのアイコン、起動画面、テーマ色を備え、ホーム画面へインストールできます。サービスワーカーはnext-pwaプラグインで設定し、Workboxの実行時キャッシュで、フォント、画像、音声、動画、CDN素材をキャッシュ優先で返し、HTTPのキャッシュ制御ヘッダーも使います。リクエストごとには、これらの素材が変わらないためです。サービスワーカーにはHTTPSが必要なので、インストールとオフライン動作は、実機でHTTPSを通して試しました。記録された成果は、インストール後にオフラインでも使い続け、再訪時にはキャッシュから読み込むアプリです。\n\nインストールの部分は、使う側から見ても違いがあります。このサイトの[アプリとしてインストールする案内](/ja/install/)は、各ブラウザーでのコマンドの場所を説明します。iPhoneのSafariなら共有メニューと「ホーム画面に追加」、パソコンのChrome、Edge、Brave、Opera、Vivaldiならアドレスバー右側の小さなアイコン、macOS Sonoma以降のSafariなら「Dockに追加」です。iOS自身は、インストールを提案しないことも記します。Firefoxは、Windowsでは143以降、Microsoft StoreからFirefoxをインストールした場合は150以降で、ウェブアプリ専用ウインドウを使えますが、macOSとLinuxでは使えません。また、このサイトをインストールして得られるのは、アイコンとウインドウであり、オフライン用コピーではない、と明示します。オフライン対応には、サービスワーカーが必要だからです。\n\n## 問題が起きるところ\n\n**利用者が古い版を使い続けます。** Service Workers仕様では、作者が明示的に求めない限り、キャッシュオブジェクトは更新されず、作者が消さない限り期限も切れません。そのため、キャッシュ優先のワーカーは、スクリプトが指示を変えるまで、昨日のスタイルシートを返し続けます。例のように、キャッシュ名にバージョンを入れ、保存するファイルが変われば名前を変え、有効化時に古いキャッシュを消します。ブラウザーは、新しく取得した`sw.js`を、インストール済みのものとバイト単位で比べるため、更新のきっかけはスクリプトの変更です。それでも、新しいワーカーは、`skipWaiting()`を呼ばなければ、古いものを使うタブやウインドウがなくなるまで待ちます。タブを開き続ける利用者は、その間ずっと古い版を使います。Next.jsのガイドは、ワーカー自身の最新版を必ず取得できるよう、`sw.js`を`Cache-Control: no-cache, no-store, must-revalidate`で配信します。\n\n**ノートパソコンでは動き、テスト用スマートフォンでは動きません。** `navigator.serviceWorker`が存在するのは、安全なコンテキストだけです。暗号化しないHTTPで開いたページでは、通常の機能確認が何も告げずに偽となり、ワーカーは登録されず、その事実がページに表示されることもありません。仕様では、ブラウザーがlocalhost、127.0.0.0/8、::1/128を開発用として許可してよいとしています。そのため、開発者自身のマシンで動くワーカーも、スマートフォンがローカルネットワーク上のそのマシンのアドレスへHTTPで接続して、同じアプリを開くと、利用できないことがあります。Next.jsには、ローカルでHTTPSを試す`next dev --experimental-https`があります。インストールもオフライン動作も、完了とする前に、実機とHTTPSで試します。\n\n**fetchリスナーが何もしません。** Service Workers仕様は、ChromiumにPWAとして認めさせるためだけに、空の`fetch`リスナーを登録するサイトがあると記します。仕様は、今では`() =\u003e {}`のようなリスナーを検出し、不要なだけでなく性能を損なう可能性もある、とブラウザーが警告することを勧めています。リクエストに応答するハンドラーを書くか、リスナー自体を付けないようにします。\n\n**インストール案内が出ることを前提にします。** 案内するかどうか、どう案内するかは、ブラウザーが決めます。Next.jsは、有効なマニフェストとHTTPSがあれば、現在のブラウザーは自動で案内すると説明する一方、`beforeinstallprompt`を使った独自ボタンは勧めません。このイベントは、すべてのブラウザーやプラットフォームで使えるわけではなく、iOSのSafariにも対応しないためです。その後、マニフェスト仕様は、イベント自体を削除しました。表示モードと開始URLも、あくまで指定側の希望です。`standalone`に非対応なら、`minimal-ui`、その次は普通のタブである`browser`へ戻ります。Next.jsのiOS向け案内のように、インストール方法を伝えつつ、タブで開いて使う場合にも対応して設計します。\n\n## 参考資料\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — マニフェストの形式、メンバー、表示モード、インストールとアンインストールの意味です。\n- [Service Workers](https://www.w3.org/TR/service-workers/) — ワーカーのライフサイクル、範囲、更新規則、安全なコンテキストの条件、Cache APIを扱います。\n- [Web Application Manifest：インストール可能なウェブアプリ](https://www.w3.org/TR/appmanifest/#installable-web-applications) — ブラウザーがアプリをインストールし、起動し、利用者が削除できるようにする仕組みです。\n- [Service Workers：キャッシュの寿命](https://www.w3.org/TR/service-workers/#cache-lifetimes) — スクリプトが指示しない限り、キャッシュオブジェクトが更新も失効もしない理由です。\n- [Next.jsでプログレッシブウェブアプリ（PWA）を作る方法](https://nextjs.org/docs/app/guides/progressive-web-apps) — マニフェストファイル、プッシュ通知、iOSのインストール案内、開発中のHTTPS、サービスワーカーのセキュリティーヘッダーです。\n\n\u003chttps://engineer.company/ja/glossary/progressive-web-app/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"ブラウザーからインストールし、接続がなくても使えるウェブサイトの仕組みを説明します。マニフェストとサービスワーカーの役割、HTTPSの条件、起きやすい四つの問題も扱います。","formats":{"gemtext":"https://engineer.company/ja/glossary/progressive-web-app/index.gmi","gopher":"https://engineer.company/ja/glossary/progressive-web-app/gophermap","html":"https://engineer.company/ja/glossary/progressive-web-app/","json":"https://engineer.company/ja/glossary/progressive-web-app/index.json","markdown":"https://engineer.company/ja/glossary/progressive-web-app/index.md","pdf":"https://engineer.company/ja/glossary/progressive-web-app/index.pdf"},"kind":"page","language":"ja","title":"プログレッシブウェブアプリとは？","url":"https://engineer.company/ja/glossary/progressive-web-app/","version":1}