Netzwerkdiagnose Capacitor Plugin

@capgo/capacitor-network-diagnostics verwenden

Native Netzwerk-Diagnose für Capacitor Apps zur Analyse von eingeschränktem WLAN, Captive Portals, blockierten Ports, WebSocket-Fehlern, langsamen Downloads und Packet Loss.

Installieren

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

Was dieses Plugin bereitstellt

• getNetworkStatus - Liest den nativen Verbindungstyp und die Netzwerk-Flags der Plattform.
• testUrl - Prüft die Erreichbarkeit von HTTP- oder HTTPS-URLs mit Status code und Latenz.
• testPort - Öffnet einen nativen TCP-Socket zu einem Host und Port.
• testWebSocket - Validiert ein ws:// oder wss:// Handshake.
• testDownloadSpeed - Misst den nativen Download-Durchsatz.
• testPacketLoss - Schätzt den Paketverlust auf Anwendungsebene mit wiederholten Probes.
• runDiagnostics - Führt einen kombinierten Diagnose-Durchlauf aus und gibt eine Problemliste zurück.

Anwendungsbeispiel

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 Nutzer, die Diagnose unter dem problematischen WLAN oder Access Point auszuführen. Senden Sie die Ergebnisse an den Support mit:

• Verbindungstyp und OS-Netzwerkflags
• fehlgeschlagene URLs, Ports oder WebSocket-Endpunkte
• Download-Mbps
• Paketverlust in Prozent
• Native Fehlercodes und -meldungen

Rohes ICMP-Ping ist in iOS- und Android-Apps nicht portabel, daher wird der Paketverlust mit wiederholten TCP- oder HTTP-Proben gemessen.

Vollständige Referenz

• GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
• Doku: /docs/plugins/network-diagnostics/