Passer au contenu principal
Retour aux plugins
@capgo/capacitor-diagnostics-de-réseau
Guide
@capgo/capacitor-diagnostics-de-réseau

Diagnostics de réseau

Exécuter des diagnostics de réseau natifs pour la disponibilité des URL, les ports TCP, les échanges de WebSocket, la vitesse et les pertes de paquets

Guide

Tutoriel sur les diagnostics de réseau

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Aperçu du plugin de diagnostics de réseau QR code

Utilisation de @capgo/capacitor-network-diagnostics

Diagnostics de réseau natifs pour les applications Capacitor qui ont besoin de 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

Ce 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 une ws:// - Main wss:// ou
  • testDownloadSpeed une poignée de main.
  • testPacketLoss - Estimer la perte de paquets au niveau de l'application avec des sondages répétés.
  • 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. Envoyer les résultats au support avec :

  • type de connexion et drapeaux de réseau OS
  • URLs, ports ou points terminus WebSocket échoués
  • téléchargement en Mbps
  • pourcentage de perte de paquets
  • codes et messages d'erreurs 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 sondages TCP ou HTTP répétés.

Référence complète