Diagnostics réseau Plugin Capacitor

Utiliser @capgo/capacitor-network-diagnostics

Diagnostics réseau natifs pour les applications Capacitor nécessitant de déboguer le Wi-Fi restreint, les portails captifs, les ports bloqués, les échecs WebSocket, les téléchargements lents et la perte de paquets.

Installer

npm install @capgo/capacitor-network-diagnostics
npx cap sync

Ce que ce plugin expose

• getNetworkStatus - Lire le type de connexion natif et les drapeaux réseau de la plateforme.
• testUrl - Vérifier la joignabilité 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 un ws:// ou wss:// handshake.
• testDownloadSpeed - Mesurer le débit de téléchargement natif.
• testPacketLoss - Estimer la perte de paquets au niveau de l'application avec des sondages répétés.
• runDiagnostics - Exécuter un passage de diagnostic combiné et renvoyer une liste des problèmes.

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);

Workflow de support

Demandez à l'utilisateur concerné de lancer un diagnostic lorsqu'il est connecté au Wi-Fi ou au point d'accès problématique. Envoyez les résultats au support avec :

• type de connexion et indicateurs réseau de l'OS
• les URL, ports ou endpoints WebSocket en échec
• débit de téléchargement (Mbps)
• le pourcentage de perte de paquets
• les codes et messages d'erreur natifs

Le ping ICMP brut n'est pas portable sur les apps iOS et Android, la perte de paquets est donc mesurée via 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/