NWPathMonitor: qué es, monitoreo de red y trabajo en iOS

¿Qué es NWPathMonitor?

NWPathMonitor es una clase del framework Network introducida por Apple en iOS 12 y macOS 10.14 Mojave. Proporciona una API moderna para rastrear cambios en la ruta de red del dispositivo — la combinación de interfaces de red a través de las cuales pasa el tráfico de la aplicación.

Antes de iOS 12, se usaba la biblioteca Reachability construida sobre el framework SystemConfiguration en C para el monitoreo de red. NWPathMonitor es una alternativa nativa en Swift con una API más rica, soporte para tipos de conexión modernos (VPN, multipath, LTE, 5G) e integración integrada con GCD.

La diferencia clave entre NWPathMonitor y Reachability — el objeto NWPath proporciona no solo un estado binario “disponible/no disponible”, sino una imagen completa de la ruta: interfaces utilizadas, su prioridad, costos, estado de roaming y capacidades de proxy y VPN. El desarrollador obtiene información completa para tomar decisiones sobre solicitudes de red.

Historia del framework Network

El framework Network surgió como un reemplazo moderno para las API de bajo nivel en C — CFStream y BSD Sockets. Proporciona una interfaz unificada para la comunicación de red en todas las plataformas Apple, incluyendo watchOS y tvOS. NWPathMonitor es parte de este framework junto con NWConnection, NWListener y NWBrowser.

El framework Network está escrito en Swift y usa GCD para procesamiento asincrónico. Esto significa que los callbacks de NWPathMonitor se ejecutan en la dispatch queue especificada, integrándose con la arquitectura de subprocesos múltiples existente de la aplicación sin gestión manual de hilos.

Cómo usar NWPathMonitor en una aplicación

El uso de NWPathMonitor comienza con la creación de una instancia de la clase y la configuración del callback pathUpdateHandler. Luego se llama al método start con una dispatch queue donde se ejecutará el closure. El monitoreo se detiene con el método cancel, que también libera recursos.

import Network

class NetworkMonitor {
    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("monitor")

    func startMonitoring() {
        monitor.pathUpdateHandler = { path in
            if path.status == .satisfied {
                print("Red disponible")
            } else {
                print("Red no disponible")
            }
        }
        monitor.start(on: queue)
    }

    func stopMonitoring() {
        monitor.cancel()
    }
}

Trabajo con tipo de interfaz

NWPathMonitor se puede configurar para monitorear solo un tipo de interfaz específico. Use el inicializador NWPathMonitor(requiredInterfaceType:) con el parámetro NWInterface.InterfaceType — .wifi, .cellular, .wiredEthernet o .loopback. Si no se especifica tipo, el monitoreo cubre todas las interfaces.

Ejemplo práctico: una aplicación de streaming puede monitorear solo Wi-Fi y advertir al usuario sobre el cambio a datos móviles. Verificar isConstrained e isExpensive en NWPath permite determinar si la conexión actual es tarificada o limitada en velocidad.

Ciclo de vida del monitoreo

El monitoreo debe iniciarse al lanzar la aplicación o al entrar en primer plano, y detenerse al entrar en segundo plano. Se recomienda crear una instancia de NWPathMonitor para toda la aplicación (singleton) y usarla desde diferentes módulos a través de un protocolo o capa de servicio.

Propiedades y capacidades de NWPath

NWPath es un objeto pasado a pathUpdateHandler que describe el estado actual de la ruta de red. Contiene cinco propiedades clave que cubren la mayoría de los escenarios de monitoreo de red. NWPath.Status — una enumeración con tres estados: satisfied (disponible), unsatisfied (no disponible) y requiresConnection (necesita conexión).

Verificación de costos y restricciones

La propiedad isExpensive es una bandera crítica para aplicaciones que trabajan con grandes volúmenes de datos. Si isExpensive = true, la aplicación debe reducir la calidad de streaming, posponer descargas de actualizaciones o advertir al usuario. isConstrained indica que el Low Data Mode está activado.

Para verificar la disponibilidad de internet (no solo de red), use el método usesInterfaceType. Si el dispositivo está conectado a Wi-Fi sin internet — NWPath puede mostrar satisfied, pero el acceso real está ausente. En estos casos, se requiere validación adicional mediante NWConnection.

Ejemplos de implementación de NWPathMonitor

Veamos una implementación avanzada de NWPathMonitor con manejo de costos, tipos de interfaz y notificación a ViewModel a través de un publisher. El ejemplo usa el framework Combine para actualizaciones reactivas de la UI cuando cambia el estado de la red.

import Network
import Combine

final class NetworkManager: ObservableObject {
    static let shared = NetworkManager()
    @Published private(set) var isConnected = true
    @Published private(set) var isExpensive = false

    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("NetworkMonitor")

    private init() {
        monitor.pathUpdateHandler = { [weak self] path in
            DispatchQueue.main.async {
                self?.isConnected = path.status == .satisfied
                self?.isExpensive = path.isExpensive
            }
        }
        monitor.start(on: queue)
    }

    func checkInterface() -> NWInterface.InterfaceType {
        let path = monitor.currentPath
        if path.usesInterfaceType(.wifi) { return .wifi }
        if path.usesInterfaceType(.cellular) { return .cellular }
        return .other
    }
}

Manejo de pérdida de red con acción diferida

Cuando se pierde la conexión, puede ser necesario no solo notificar a la UI sino también realizar acciones diferidas — por ejemplo, guardar un borrador de solicitud para enviarlo después. Implemente una cola de solicitudes diferidas que acumula operaciones durante el estado unsatisfied y las envía cuando se restaura satisfied.

El patrón ReachabilityManager con delegado es ideal para esta tarea: NWPathMonitor notifica al manager, el manager actualiza la cola y la UI. Cuando el estado cambia a satisfied, la cola se vacía automáticamente y la UI recibe una indicación de restauración de conexión.

NWPathMonitor vs Reachability

Antes de NWPathMonitor, la solución estándar para monitoreo de red en iOS era la biblioteca Reachability de Apple (ejemplo de la documentación), construida sobre SystemConfiguration. Las principales diferencias: Reachability funciona a través de SCNetworkReachability en C, no admite tipos de red modernos y solo proporciona una respuesta binaria de disponibilidad.

NWPathMonitor soluciona estas limitaciones: está escrito en Swift, soporta VPN, multipath, 5G y LTE, proporciona información detallada sobre cada interfaz y funciona de forma asincrónica a través de GCD. Reachability todavía se usa en proyectos con soporte mínimo de iOS 11 e inferior.

Cuándo usar Reachability

Si tu aplicación soporta iOS 11 e inferior, Reachability sigue siendo la única opción. Para proyectos iOS 12+, se recomienda usar NWPathMonitor directamente — se integra mejor con el código Swift moderno, Combine y SwiftUI.

La migración de Reachability a NWPathMonitor es sencilla: simplemente reemplace las llamadas SCNetworkReachability con NWPathMonitor, conservando la misma lógica de manejo. Una capa de abstracción (NetworkMonitorProtocol) permitirá cambiar entre implementaciones sin modificar la lógica de negocio de la aplicación.