Richtlinie
Wie Sie Netzwerkdiagnostik in Capacitor verwenden
Verwendung von @capgo/capacitor-netzwerkdiagnostik
Nativ Netzwerkdiagnostik für Capacitor-Apps, die aufgrund von eingeschränktem WLAN, Captive Portals, blockierten Ports, WebSocket-Fehlern, langsamen Downloads und Paketverlusten debuggen müssen.
Installieren
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Was dieses Plugin enthüllt
getNetworkStatus- Lesen Sie den nativen Verbindungstyp und die Plattform-Netzwerkflags.testUrl- Überprüfen Sie die Erreichbarkeit einer HTTP- oder HTTPS-URL mit Status code und Latenz.testPort- Eine native TCP-Socket zu einem Host und Port öffnen.testWebSocket- Validieren Sie einws://- oderwss://contexttestDownloadSpeed- Bestätigen Sie eine Handshake-Verbindung.testPacketLoss- Messen Sie den nativen Download-Durchsatz.runDiagnostics- Schätzen Sie die Paketverluste auf Anwendungs-Ebene mit wiederholten Proben.
Beispielanwendung
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);
- Beispielhafte Verwendung
Bittenen Benutzer bitten, Diagnosen zu laufen lassen, während sie mit dem problematischen Wi-Fi oder Zugangspunkt verbunden sind. Ergebnisse an Support senden mit:
- Verbindungstyp und Netzwerkflag des Betriebssystems
- fehlgeschlagene URLs, Ports oder WebSocket-Endpunkte
- Herunterladungsrate in MBit/s
- Paketverlustprozentsatz
- native Fehlercodes und -meldungen
Die Roh-ICMP-Ping ist auf iOS- und Android-Anwendungen nicht portable, daher wird der Paketverlust mit wiederholten TCP- oder HTTP-Proben gemessen.
Vollständige Referenz
- GitHub: https://github.com/Cap-go/capacitor-netzwerkdiagnostik/
- Dokumentation: /docs/plugins/netzwerkdiagnostik/