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

Diagnostics de réseau

Exécutez des diagnostics de réseau natifs pour la disponibilité de l'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 code QR code.

Lien QR de prévisualisation du plugin de diagnostics de réseau code

Utilisation de @capgo/capacitor-network-diagnostics

Diagnostic de réseau natif 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 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'un ws:// - ou wss:// échange de données.
  • testDownloadSpeed - Mesurer la vitesse de téléchargement native.
  • testPacketLoss - Estimer les pertes 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 travail 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 les drapeaux de réseau OS
  • URLs, ports ou points de terminaison WebSocket échoués
  • téléchargement en Mbps
  • pourcentage de pertes de paquets
  • 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