URLの到達可能性、TCPポート、WebSocketハンドシェイク、速度、パケットロスについてネイティブネットワーク診断を実行します
まずは getNetworkStatus() および以下に示すその他のコアメソッド。
プラットフォーム対応
「プラットフォーム対応」という見出しのセクション| プラットフォーム | サポート | 備考 |
|---|---|---|
| iOSと | はい | ネイティブ |
| Androidでは | はい | ネイティブ |
| Web | いいえ | Capacitor.getPlatform() でガード |
コア機能
「コア機能」セクションgetNetworkStatus- ネイティブの接続タイプとプラットフォームのネットワークフラグを読み取ります。testUrl- HTTP/HTTPS URL の到達性を、ステータス code とレイテンシで確認します。testPort- ホストとポートに対してネイティブ TCP ソケットを開きます。testWebSocket- 次を検証します:ws://またはwss://ハンドシェイク。testDownloadSpeed- 独自のテストファイルエンドポイントからネイティブのダウンロードスループットを測定します。testPacketLoss- 繰り返し実行される TCP または HTTP プロブにより、アプリケーションレベルのパケットロスを推定します。runDiagnostics- 統合診断パスを実行し、コンパクトな問題リストを返します。
生の ICMP ping は App Store および Play Store のアプリで常に利用可能ではないため、パケットロスは繰り返し実行される TCP または HTTP プロブで測定されます。
公開 API
「Public API」セクション| メソッド | 説明 |
|---|---|
getNetworkStatus | 現在のネイティブ接続タイプとプラットフォームのネットワークフラグを読み取ります。 |
testUrl | ネイティブネットワークからHTTPまたはHTTPS URLに到達できるかテストします。 |
testPort | ネイティブネットワークからTCPホストとポートを開けるかテストします。 |
testWebSocket | WebSocket URLがネイティブハンドシェイクを完了できるかテストします。 |
testDownloadSpeed | ネイティブHTTPリクエストからのダウンロードスループットを測定します。 |
testPacketLoss | TCPまたはHTTPプローブを繰り返し実行して、アプリケーションレベルのパケット損失を推定します。 |
runDiagnostics | 複数の診断を実行し、簡潔な問題リストを返します。 |
getPluginVersion | ネイティブプラグインのバージョンマーカーを返します。 |
Source of Truth
「Source Of Truth」セクションこのリファレンスは以下から同期されています: src/definitions.ts における capacitor-network-diagnostics.