Guida
Tutorial di rete diagnostica
Utilizza @capgo/capacitor-diagnostica-di-rete
Diagnostica di rete nativa per le app Capacitor che necessitano di debuggare 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
Cos'è questo plugin
getNetworkStatus- Leggi il tipo di connessione nativa e le flag di rete del platform.testUrl- Verifica la raggiungibilità di un URL HTTP o HTTPS con stato code e latenza.testPort- Apri un socket TCP nativo a un host e una porta.testWebSocket- Verifica unws://owss://handshake.testDownloadSpeed- Misura il throughput di download nativo.testPacketLoss- Stima la perdita di pacchetti a livello di applicazione con prove ripetute.runDiagnostics- Esegui una passata diagnostica combinata 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 diagnosi mentre è connesso al Wi-Fi o all'access point problematico. Inviare i risultati al supporto con:
- tipo di connessione e flag di rete OS
- URL, porte o endpoint WebSocket falliti
- download Mbps
- percentuale di perdita di pacchetti
- codici e messaggi di errore nativi
La ping ICMP crudo non è portabile su iOS e app Android, quindi la perdita di pacchetti viene misurata con ricerche TCP o HTTP ripetute.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-diagnostiche-di-rete/
- Documentazione: /docs/plugins/diagnostiche-di-rete/