メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-network-diagnostics
チュートリアル
@capgo/capacitor-network-diagnostics

ネットワーク診断

URLの到達性、TCPポート、WebSocketハンドシェイク、速度、パケットロスなどを含むネイティブのネットワーク診断を実行します。

ガイド

ネットワーク診断のチュートリアル

@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プローブで測定されます。

フルリファレンス