Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-Netzwerkdiagnose
Anleitung
@capgo/capacitor-Netzwerkdiagnose

Netzwerkdiagnose

Für die URL-Zugänglichkeit, TCP-Ports, WebSocket-Handshakes, Geschwindigkeit und Paketverlust führen Sie native Netzwerkdiagnosen durch

Führung

Anleitung zur Netzwerkdiagnose

Testen auf Gerät

Herunterladen der Capgo-App, dann scannen Sie die QR-Code code.

Netzwerk-Diagnose-Plugin-Vorschau-QR code

Verwendung von @capgo/capacitor-netzwerkdiagnose

Nativ Netzwerkdiagnose für Capacitor-Apps, die auf die Fehlersuche von eingeschränkten Wi-Fi, Captive Portals, blockierten Ports, WebSocket-Fehlern, langsamen Downloads und Paketverlust angewiesen sind.

Installieren

npm install @capgo/capacitor-network-diagnostics
npx cap sync

Was diese Plugin-Exposition enthält

  • getNetworkStatus - Lese die native Verbindungstyp und Plattform-Netzwerkflags.
  • testUrl - Überprüfe die HTTP- oder HTTPS-URL-Erreichbarkeit mit Status code und Latenz.
  • testPort - Öffne einen nativen TCP-Socket zu einem Host und einer Port.
  • testWebSocket oder ws:// Entweder wss:// Handshake.
  • testDownloadSpeed - Messen Sie die native Herunterladegeschwindigkeit.
  • testPacketLoss - Schätzen Sie die Paketverlustrate auf Anwendungslevel mit wiederholten Proben.
  • runDiagnostics - Führen Sie eine kombinierte Diagnose durch und geben Sie eine Liste mit Problemen zurück.

Beispiel für die Verwendung

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);

Unterstützungsweg

Bitten Sie den betroffenen Benutzer, Diagnosen durchzuführen, während er mit dem problematischen Wi-Fi-Netzwerk oder Zugangspunkt verbunden ist. Senden Sie die Ergebnisse an den Support mit:

  • Verbindungstyp und Netzwerkflags des Betriebssystems
  • fehlgeschlagene URLs, Ports oder WebSocket-Endpunkte
  • Herunterladegeschwindigkeit in Mbps
  • Paketverlustprozentsatz
  • native Fehlercodes und -meldungen

Raw ICMP Ping ist nicht auf iOS- und Android-Apps portable, daher wird der Paketverlust mit wiederholten TCP- oder HTTP-Proben gemessen.

Vollständige Referenz