# Pekemalu-WebAppTroubleshooter Webアプリのトラブル切り分けを支援する、ブラウザベースの診断ツールです。 「カメラが起動しない」「API通信がうまくいかない」「ファイルがダウンロードできない」「ブラウザによって動作が違う」——。 Webアプリの開発や動作確認では、こうした問題に遭遇することがあります。 Pekemalu-WebAppTroubleshooter は、ブラウザから確認できるAPI・機能・実行環境などを診断し、問題の切り分けを支援します。 診断結果は `PASS` / `FAIL` / `UNKNOWN` の3種類で表示します。 確認できたこと、問題が検出されたこと、そして確認できなかったことを区別することで、トラブル調査の手がかりを得るためのツールです。 --- ## 🔎 こんなときに ・WebアプリでカメラやQRコード読み取りが動作しない\ ・API通信やネットワーク関連の問題を調査したい\ ・ファイルのダウンロードがうまくいかない\ ・ブラウザのストレージ機能が利用できるか確認したい\ ・PC、スマートフォン、PWAなどで動作の違いを調べたい\ ・マイクや音声関連のAPI・実行環境を確認したい\ ・Webアプリの不具合について、まずブラウザ側の状態を整理したい 問題の原因をひとつに決めつけるのではなく、ブラウザから確認できる情報を整理し、次の調査につなげる用途に向いています。 --- ## ✨ 6つの診断機能 ### 🖥️ Runtime Environment ブラウザや実行環境に関する項目を診断します。 利用しているブラウザや実行環境の違いによってWebアプリの挙動が変わる場合に、環境面から問題を切り分けるための機能です。 ### 💾 Storage ブラウザのストレージ関連の機能を診断します。 `localStorage` や `sessionStorage` などへのアクセス・読み書き、ストレージ関連APIの状態を確認します。 ### 📷 Camera / QR カメラやQRコード関連の機能について、ブラウザから確認できる項目を診断します。 カメラ関連のAPIや実行環境など、動作に関わる要素を確認するための機能です。 ### 🎙️ Microphone / Audio マイク・音声関連のAPIや実行環境を診断します。 マイクへのアクセスや音声機能に関係する項目を確認し、音声関連の問題を調査するための手がかりを得られます。 ### 🌐 API / Network API通信・ネットワーク関連の項目を診断します。 Webアプリの通信に関する問題を調査する際の、切り分けの手がかりとして利用できます。 ### 📥 File Download ファイルダウンロード関連の動作を診断します。 ブラウザ上でのダウンロード機能に関する問題を調査する際に利用できます。 --- ## 📊 診断結果について 診断結果は、次の3種類で表示します。 - `PASS`：確認対象の項目が正常と判断できた - `FAIL`：確認対象の項目で問題が検出された - `UNKNOWN`：情報不足や実行環境の制約などにより、判定できなかった **`UNKNOWN` は `FAIL` を意味しません。** ブラウザの仕様、権限の状態、実行環境などによっては、すべての項目を確認できるとは限りません。 確認できなかった項目を失敗と決めつけず、確認結果を区別して扱うことを重視しています。 --- ## 🧭 このツールの位置づけ 本ツールは、ブラウザから観測できる情報をもとに、Webアプリのトラブル切り分けを支援するためのものです。 診断結果だけで、アプリケーションの不具合原因を必ず特定できるわけではありません。 サーバー側の問題、アプリケーション固有の実装、ネットワーク構成、ブラウザや端末固有の制約など、別途調査が必要になる場合があります。 診断結果を調査の出発点として利用し、必要に応じて開発者ツールやログなどと組み合わせてご活用ください。 --- ## 📦 商品に含まれるもの 商品ZIPには、以下を含めています。 ・ビルド済みアプリケーション (`dist/`)\ ・TypeScript / JavaScript ソースコード (`src/`)\ ・テストコード (`tests/`)\ ・README\ ・CHANGELOG\ ・LICENSE\ ・npm / Vite / TypeScript / Vitest 等の開発用設定ファイル `node_modules/` は含まれていません。 --- ## 🌐 動作環境 ### アプリケーションの利用 ・モダンブラウザを想定\ ・ブラウザのAPIや機能を利用できる環境\ ・カメラやマイクなど、一部の機能ではブラウザのセキュリティ要件を満たす実行環境が必要です ブラウザ、端末、権限設定、実行環境などによって、診断できる項目や結果が異なる場合があります。 ### ソースコードの開発・テスト・ビルド 商品にはソースコードと開発用設定も含まれています。 ソースから開発・テスト・ビルドを行う場合は、Node.js などの開発環境が必要です。 具体的なセットアップ方法については、商品に同梱している README をご確認ください。 --- ## ⚠️ 注意事項 ・本ツールは、ブラウザから確認できる範囲で診断を行います。すべての不具合の原因を特定できることを保証するものではありません。\ ・診断結果は実行時のブラウザや環境に依存します。\ ・権限の許可・拒否やブラウザの仕様などによって、一部の項目が `UNKNOWN` となる場合があります。\ ・診断結果は、実際のWebアプリケーション全体の正常動作を保証するものではありません。 --- ## 📜 ライセンス 本商品に含まれるソースコードやファイルの利用・改変・再配布等の条件については、商品に同梱している `LICENSE.txt` をご確認ください。 --- ## 🔖 Version **1.0.0** Pekemalu Works