ガイド
ネットワーク診断のチュートリアル
@capgo/capacitor-network-diagnosticsを使用
Wi-Fiが制限されている、キャプティブ ポータル、ブロックされたポート、WebSocketの失敗、ダウンロードが遅い、パケットの喪失など、Capacitor アプリがデバッグする必要があるネットワークの制限された環境向けのネイティブ ネットワーク ディアグナスティック
インストール
npm install @capgo/capacitor-network-diagnostics
npx cap sync
このプラグインが公開するもの
getNetworkStatus- ネイティブ接続タイプとプラットフォームネットワークフラグを読みます。testUrl- HTTP または HTTPS URL の到達性を確認するには、ステータス code と遅延を使用します。testPort- ホストとポートにnative TCPソケットを開きます。testWebSocket- を検証するws://- ハンドシェイクを検証するwss://- ネイティブのダウンロードスループットを測定するtestDownloadSpeed- ネイティブのパケットロスを再帰的にプローブして推定するtestPacketLoss- combination診断を実行し、問題リストを返します。runDiagnostics例:使用方法
サポートワークフロー
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ネットワークフラグ
- connection type and OS network flags
- 失敗したURL、ポート、またはWebSocketエンドポイント
- ダウンロードMbps
- パケットロス率
- ネイティブエラー コードとメッセージ
iOSおよびAndroidアプリでは、Raw ICMP pingは移植性が低いため、パケットロスは繰り返しTCPまたはHTTPプローブで測定されます。
フルリファレンス
- GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
- ドキュメント: /docs/plugins/network-diagnostics/