NetworkReachabilityManager

open class NetworkReachabilityManager

The NetworkReachabilityManager class listens for reachability changes of hosts and addresses for both WWAN and WiFi network interfaces.

Reachability can be used to determine background information about why a network operation failed, or to retry network requests when a connection is established. It should not be used to prevent a user from initiating a network request, as it’s possible that an initial request may be required to establish reachability.

  • Defines the various states of network reachability.

    • Unknown: It is unknown whether the network is reachable.
    • NotReachable: The network is not reachable.
    • ReachableOnWWAN: The network is reachable over the WWAN connection.
    • ReachableOnWiFi: The network is reachable over the WiFi connection.

    Declaration

    Swift

    public enum NetworkReachabilityStatus
    Show on GitHub

  • A closure executed when the network reachability status changes. The closure takes a single argument: the network reachability status.

    Declaration

    Swift

    public typealias Listener = (NetworkReachabilityStatus) -> Void
    Show on GitHub

  • Defines the various connection types detected by reachability flags.

    • ethernetOrWiFi: The connection type is either over Ethernet or WiFi.
    • wwan: The connection type is a WWAN connection.

    Declaration

    Swift

    public enum ConnectionType
    Show on GitHub

Properties

Initialization

  • Creates a NetworkReachabilityManager instance with the specified host.

    Declaration

    Swift

    public convenience init?(host: String)
    Show on GitHub

  • Creates a NetworkReachabilityManager instance that monitors the address 0.0.0.0.

    Reachability treats the 0.0.0.0 address as a special token that causes it to monitor the general routing status of the device, both IPv4 and IPv6.

    Declaration

    Swift

    public convenience init?()
    Show on GitHub

Listening