ガイド
Wi-Fi制限、キャプティブゲートウェイ、ブロックされたポート、WebSocketの失敗、ダウンロードの遅延、パケットロスの診断
Using @capgo/capacitor-network-diagnostics
Native network diagnostics for Capacitor apps that need to debug restricted Wi-Fi, captive portals, blocked ports, WebSocket failures, slow downloads, and packet loss.
このプラグインが公開するもの
npm install @capgo/capacitor-network-diagnostics
npx cap sync
- ネイティブ接続タイプとプラットフォームネットワークフラグを読み取る
getNetworkStatus- HTTPまたはHTTPSのURLに到達するかどうかをステータスコード__CAPGO_KEEP_0__と遅延で確認するtestUrl- Check HTTP or HTTPS URL reachability with status code and latency.testPort-testWebSocketまたはws://orwss://__CAPGO_KEEP_0__.testDownloadSpeed- ネイティブダウンロードスループットを測定します。testPacketLoss- 再帰的なプローブを使用してアプリケーションレベルのパケットロスを推定します。runDiagnostics- combination診断パスを実行し、問題リストを返します。
例:使用方法
import { NetworkDiagnostics } from '@capgo/capacitor-network-diagnostics';
const report = await NetworkDiagnostics.runDiagnostics({
urls: [{ url: 'https://api.example.com/health' }],
ports: [{ host: 'api.example.com', port: 443 }],
websockets: [{ url: 'wss://ws.example.com/socket' }],
packetLoss: {
mode: 'tcp',
host: 'api.example.com',
port: 443,
count: 10,
},
});
console.log(report.status);
console.log(report.issues);
サポートワークフロー
影響を受けたユーザーに、問題のあるWi-Fiまたはアクセスポイントに接続されているときに診断を実行するよう求めます。サポートに結果を送信します:
- 接続タイプとOSネットワークフラグ
- 失敗したURL、ポート、またはWebSocketエンドポイント
- ダウンロードMbps
- パケットロス率
- ネイティブエラーコードとメッセージ
iOSとAndroidアプリでは、Raw ICMP pingが移植できないため、パケットロスは繰り返しTCPまたはHTTPプローブで測定されます。
Full Reference
- GitHub https://github.com/Cap-go/capacitor-network-diagnostics/
- ドキュメント: /docs/plugins/network-diagnostics/