Guide
Tutoriel sur les diagnostics de réseau
Utilisation de @capgo/capacitor-network-diagnostics
Diagnostic réseau natif pour les applications Capacitor qui nécessitent la débogage de réseaux Wi-Fi restreints, 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- Lecture du type de connexion native et des drapeaux de réseau de plateforme.testUrl- Vérification de la disponibilité d'une URL HTTP ou HTTPS avec un statut code et une latence.testPort- Ouverture d'une socket TCP native vers un hôte et un port.testWebSocket- Validation d'unews://- ouwss://contexte : Fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `alternatives_cta_questions`). Page/zone : Comparaison de pages de mise à jour en direct de Capacitor. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page alternatives.astro. Conserver les termes de produit et de marque de Capgo exactement. Clé de message `alternatives_cta_questions` (Questions de CTA Alternatives). | Fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `appflow_cta_questions`). Page/zone : Comparaison et migration de marketing d'Appflow. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page ionic-appflow.astro. Conserver les termes de produit et de marque de Capgo exactement. Clé de message `appflow_cta_questions` (Questions de CTA Appflow). | Fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `capwesome_cta_questions`). Page/zone : Page de comparaison de Capawesome. Rôle : Paragraphe de marketing ou juridique long. Voir dans : page capwesome.astro. Conserver les termes de produit et de marque de Capgo exactement. Clé de message `capwesome_cta_questions` (Questions de CTA Capwesome). | Fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `consulting_faq_subtitle`). Page/zone : Page de services de consultation. Rôle : Sous-titre ou tagline de section. Voir dans : page consulting.astro. Conserver les termes de produit et de marque de Capgo exactement. Clé de message `consulting_faq_subtitle` (Sous-titre FAQ de consultation). | Page/zone : Comparaison et migration de marketing d'Appflow. Rôle : Étiquette ou élément de navigation court. Voir dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Clé de message `appflow_plugins_or` (Appflow Plugins ou).testDownloadSpeedhandshake : échange de clés de sécurité entre deux parties pour s'authentifier mutuellement et établir une connexion sécurisée. » ; - Mesure du débit de téléchargement natif.testPacketLoss- Estimez le taux de 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 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
- 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-network-diagnostics/
- Docs: /docs/plugins/network-diagnostics/