Richtlinie
Tutorial zur Netzwerkdiagnose
Verwendung von @capgo/capacitor-netzwerkdiagnose
Nativere Netzwerkdiagnose für Capacitor-Apps, die eine Debugging von eingeschränkten Wi-Fi, Captive Portals, blockierten Ports, WebSocket-Fehlern, langsamen Downloads und Paketverlust benötigen.
Installieren
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Was diese Erweiterung offenlegt
getNetworkStatus- Die native Verbindungstyp und Plattform-Netzwerkflags lesen.testUrl- Überprüfen Sie die Erreichbarkeit einer HTTP- oder HTTPS-URL mit Status code und Latenz.testPort- Öffnen Sie eine native TCP-Socket-Verbindung zu einem Host und einer Port.testWebSocket- Überprüfen Sie einews://oderwss://Handshake.testDownloadSpeed- Messen Sie die native Herunterladegeschwindigkeit.testPacketLoss- Schätzen Sie die Paketverlustrate auf Anwendungs-Ebene mit wiederholten Proben.runDiagnostics- Führen Sie einen kombinierten Diagnosevorgang durch und geben Sie eine Liste mit Problemen zurück.
Beispiel zur 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);
Support-Workflow
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 OS-Netzwerkflags
- fehlgeschlagene URLs, Ports oder WebSocket-Endpunkte
- Herunterladegeschwindigkeit in Mbps
- Paketverlustprozentsatz
- native Fehlercodes und -Meldungen
Raw ICMP ping ist nicht portable auf iOS- und Android-Anwendungen, daher wird der Paketverlust mit wiederholten TCP- oder HTTP-Proben gemessen.
Vollständige Referenz
- GitHub: https://github.com/Cap-go/capacitor-Netzwerkdiagnosen/
- Dokumentation: /docs/plugins/netzwerkdiagnosen/