Saltar al contenido

@capgo/capacitor-network-diagnostics

Ejecuta diagnósticos de red nativos para accesibilidad de URL, puertos TCP, handshakes de WebSocket, velocidad y pérdida de paquetes

Ejecuta diagnósticos de red nativos para accesibilidad de URL, puertos TCP, handshakes de WebSocket, velocidad y pérdida de paquetes

Empieza con getNetworkStatus() y los demás métodos principales detallados abajo.

PlataformaSoporteNotas
iOSSíNativo
AndroidSíNativo
WebNoProtege con Capacitor.getPlatform()
  • getNetworkStatus - Lee el tipo de conexión nativa y los flags de red de la plataforma.
  • testUrl - Comprueba la accesibilidad de una URL HTTP o HTTPS con estado code y latencia.
  • testPort - Abre un socket TCP nativo a un host y puerto.
  • testWebSocket - Valida un ws:// o wss:// handshake.
  • testDownloadSpeed - Mide el throughput de descarga nativa desde tu propio endpoint de archivo de prueba.
  • testPacketLoss - Estima la pérdida de paquetes a nivel de aplicación con sondeos TCP o HTTP.
  • runDiagnostics - Ejecuta un diagnóstico combinado y devuelve una lista compacta de problemas.

El ping ICMP puro no está disponible de forma constante en las apps de App Store y Play Store, así que la pérdida de paquetes se mide con sondeos TCP o HTTP repetidos.

MétodoDescripción
getNetworkStatusLee el tipo de conexión nativa actual y los flags de red de la plataforma.
testUrlComprueba si una URL HTTP o HTTPS es accesible mediante la red nativa.
testPortComprueba si se puede abrir un host y puerto TCP desde la red nativa.
testWebSocketComprueba si una URL de WebSocket puede completar su handshake nativo.
testDownloadSpeedMide el throughput de descarga desde una petición HTTP nativa.
testPacketLossEstima la pérdida de paquetes a nivel de aplicación con sondeos TCP o HTTP.
runDiagnosticsEjecuta varios diagnósticos y devuelve una lista compacta de problemas.
getPluginVersionDevuelve el marcador de versión del plugin nativo.

Esta referencia se sincroniza desde src/definitions.ts en capacitor-network-diagnostics.