Guía
Tutorial de Diagnósticos de Red
Usando @capgo/capacitor-diagnósticos-de-red
Diagnósticos de red nativos para aplicaciones Capacitor que necesitan depurar Wi-Fi restringido, puertas de enlace captivas, puertos bloqueados, fallos de WebSocket, descargas lentas y pérdida de paquetes
Instalar
npm install @capgo/capacitor-network-diagnostics
npx cap sync
¿Qué Esta Plugin Exposa
getNetworkStatus- Leer el tipo de conexión nativa y las banderas de red de plataforma.testUrl- Verificar la accesibilidad de una URL HTTP o HTTPS con el estado code y la latencia.testPort- Abrir un socket TCP nativo a un host y puerto.testWebSocket- Validar unws://- Realizar unawss://- Medir el tráfico de descarga nativo.testDownloadSpeed- Estimar la pérdida de paquetes a nivel de aplicación con sondas repetidas.testPacketLoss- Ejecutar una pasada diagnóstica combinada y devolver una lista de problemas.runDiagnosticsEjemplo de Uso
Flujo de Soporte
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);
¿Qué Esta Plugin Exposa
Pida al usuario afectado que ejecute diagnósticos mientras se encuentra conectado a la red Wi-Fi o punto de acceso problemática. Envíe los resultados a soporte con:
- tipo de conexión y banderas de red del sistema operativo
- URLs, puertos o puntos finales de WebSocket fallidos
- tasa de descarga en Mbps
- porcentaje de pérdida de paquetes
- códigos y mensajes de error nativos
El ping ICMP bruto no es portable en aplicaciones de iOS y Android, por lo que la pérdida de paquetes se mide con sondas TCP o HTTP repetidas.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-diagnósticos-de-red/
- Documentación: /docs/plugins/diagnósticos-de-red/