Guide
Tutoriel sur les diagnostics de réseau
En utilisant @capgo/capacitor-network-diagnostics
Diagnostic de réseau natif pour les applications Capacitor qui doivent déboguer des Wi-Fi restreints, des portails captifs, des ports bloqués, les échecs de WebSocket, les téléchargements lents et la perte de paquets.
Installer
npm install @capgo/capacitor-network-diagnostics
npx cap sync
Ceci que ce plugin expose
getNetworkStatus- Lire le type de connexion native et les drapeaux de réseau de plateforme.testUrl- Vérifier la disponibilité d'une URL HTTP ou HTTPS avec un statut code et une latence.testPort- Ouvrir un socket TCP natif vers un hôte et un port.testWebSocket- Valider unws://- ouwss://ouverture de main.testDownloadSpeed- Mesurer le débit de téléchargement natif.testPacketLoss- Estimez la perte de paquets au niveau de l'application avec des sondes répétées.runDiagnostics- Exécutez une passe de diagnostic combinée et renvoyez une liste d'erreurs.
- 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);
- Flux de workflow de support
- Demandez à l'utilisateur affecté de lancer les diagnostics tout en étant connecté au Wi-Fi ou au point d'accès problématique. Envoyez les résultats au support avec :
- - type de connexion et drapeaux de réseau OS
- - URL, ports ou points de terminaison WebSocket échoués
- - téléchargement Mbps
- - pourcentage 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-network-diagnostics/
- Docs: /docs/plugins/network-diagnostics/