Guida
Come utilizzare le Diagnosi di Rete in Capacitor
Utilizzo di @capgo/capacitor-network-diagnostics
Diagnosi di rete native per le app Capacitor che devono debuggere Wi-Fi limitati, porte captive, porte bloccate, fallimenti WebSocket, download lenti e perdita di pacchetti.
Installa
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Cosa questo plugin esporre
getNetworkStatus- Leggi il tipo di connessione nativa e le flag di rete della piattaforma.testUrl- Controlla la raggiungibilità dell'URL HTTP o HTTPS con lo stato code e la latenza.testPort- Apri una connessione TCP nativa a un host e una porta.testWebSocket- Valuta unws://- owss://handshake.testDownloadSpeed- Misura il throughput di download nativo.testPacketLossStima la perdita di pacchetti a livello di applicazione con prove ripetute.runDiagnostics- Esegui un passaggio diagnostico combinato e restituisci una lista di problemi.
- Esempio di utilizzo
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);
- Flusso di lavoro di supporto
- Chiedi all'utente interessato di eseguire le diagnostica mentre è connesso alla rete Wi-Fi problematica o all'access point. Inviare i risultati al supporto con:
- tipologia di connessione e flag di rete OS
- URLs, porte o endpoint WebSocket non riusciti
- download Mbps
- percentuale di perdita di pacchetti
- codici e messaggi di errore nativi
La ping ICMP crudo non è portabile su app iOS e Android, quindi la perdita di pacchetti viene misurata con probe TCP o HTTP ripetuti.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-diagnostiche-di-rete/
- Documentazione: /docs/plugins/diagnostiche-di-rete/