Guide
Comment utiliser les diagnostics de réseau dans Capacitor
Utilisation de @capgo/capacitor-network-diagnostics
Diagnostic réseau natif pour les applications Capacitor qui nécessitent la débogage de Wi-Fi restreint, de portails captifs, de ports bloqués, d'échecs de WebSocket, de téléchargements lents et de pertes de paquets.
Installer
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Ce que ce plugin expose
getNetworkStatus- Lit le type de connexion natif et les drapeaux de réseau de la plateforme.testUrlVérifiez la disponibilité d'une URL HTTP ou HTTPS avec le statut code et la latence.testPort- Ouvrez un socket TCP natif vers un hôte et un port.testWebSocket- Validez unws://- ouwss://handshake.testDownloadSpeed- Effectuez un échange de main.testPacketLoss- Estime la perte de paquets au niveau de l'application avec des sondages répétés.runDiagnostics- Estimez la perte de paquets au niveau de l'application avec des sondages répétés.
Exemple d'utilisation
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);
- Exemple d'utilisation
Demandez à l'utilisateur affecté d'exécuter des diagnostics tout en étant connecté au Wi-Fi ou au point d'accès problématique. Envoyez les résultats au support avec :
- connection type and OS network flags
- URLs, ports ou points de terminaison WebSocket échoués
- téléchargement Mbps
- taux de perte de paquets
- codes et messages d'erreur natifs
Le ping ICMP brut n'est pas portable sur les applications iOS et Android, donc la perte de paquets est mesurée avec des sondes TCP ou HTTP répétées.
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-diagnostics-de-réseau/
- Docs : /docs/plugins/network-diagnostics/