Guide
Guide de tutoriel sur les diagnostics de réseau
Utilisation de @capgo/capacitor-network-diagnostics
Diagnostics de réseau natifs 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 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 le statut code et la latence.testPort- Ouvrir un socket TCP natif vers un hôte et un port.testWebSocket- Valider unws://ouwss://handshake.testDownloadSpeed- Mesurer le débit de téléchargement natif.testPacketLoss- Estimer la perte de paquets au niveau de l'application avec des sondes répétées.runDiagnostics- Exécuter une passe de diagnostic combinée et retourner 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 support
Demander à l'utilisateur affecté de lancer les diagnostics tout en étant connecté au Wi-Fi ou au point d'accès problématique.
- type de connexion et les drapeaux de réseau OS
- URLs, ports ou points de terminaison WebSocket échoués
- téléchargement Mbps
- pourcentage de perte de paquets
- Les codes et messages d'erreur natives
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/diagnostics-de-réseau/