Guida
Tutorial sulle diagnosi di rete
Usando @capgo/capacitor-diagnostica-di-rete
Diagnostica di rete nativa per le Capacitor che necessitano di debuggare Wi-Fi ristretti, porte captive, porte bloccate, fallimenti WebSocket, download lenti e perdita di pacchetti.
Installa
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Cos'è che questo plugin espone
getNetworkStatus- Legge il tipo di connessione nativa e le flag di rete del platform.testUrl- Controlla la raggiungibilità di un URL HTTP o HTTPS con stato code e latenza.testPort- Apri un socket TCP nativo a un host e porta.testWebSocket- Valida unws://- owss://controlla se è valido untestDownloadSpeedhandshake.testPacketLoss- Stima la perdita di pacchetti a livello di applicazione con prove ripetute.runDiagnostics- Eseguire un passaggio diagnostico combinato e restituire 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
Chiedere all'utente interessato di eseguire le diagnostica 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
Il ping ICMP crudo non è portabile su iOS e Android, quindi la perdita di pacchetti viene misurata con prove TCP o HTTP ripetute.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
- Documentazione: /docs/plugins/network-diagnostics/