Network Reachability With Swift


A day, I had been using the Alamofire NetworkReachabilityManager
class—to check the network state of the user’s device—and suddenly I have found a bug because of an edge-case scenario. At that point, I decided to learn well how this class works and how to contribute to fix the issue.

The result is in this Pull Request: Alamofire #2060

I think that network reachability is an interesting topic to know, therefore I want to share with you how it works.

Happy Reading!


What Is Network Reachability?

Network Reachability
is the network state of the user’s device. We can use it to understand if the device is offline or online using either wifi or mobile data.

To read these informations, we can use the interface of

provided by the framework SystemConfiguration
. We can use it to read the network informations both synchronously and asynchronously.

Let’s start step by step using this interface.


Once imported the framework SystemConfiguration
merely with:

import SystemConfiguration

The first step is the instantiation of a SCNetworkReachability
object. There are mainly two ways to do it:

1. Using a hostname:

We can use the function SCNetworkReachabilityCreateWithName
which needs a hostname as argument:

let reachability = SCNetworkReachabilityCreateWithName(nil, "")
// Or also with localhost
let reachability = SCNetworkReachabilityCreateWithName(nil, "localhost")

The first parameter is the allocator, we can pass nil
to use the default one. SCNetworkReachabilityCreateWithName
returns an optional value, therefore we have to unwrap it.

2. Using a network address reference:

// Initializes the socket IPv4 address struct
var address = sockaddr_in()
address.sin_len = UInt8(MemoryLayout.size)
address.sin_family = sa_family_t(AF_INET)
// Passes the reference of the struct
let reachability = withUnsafePointer(to: &address, { pointer in
    // Converts to a generic socket address
    return pointer.withMemoryRebound(to: sockaddr.self, capacity: MemoryLayout.size) {
        // $0 is the pointer to `sockaddr`
        return SCNetworkReachabilityCreateWithAddress(nil, $0)

Network Flags

Once we have a SCNetworkReachability
object, we are ready to use the network state informations.

provides these informations with a set of flags—


I copy here, from the official documentation, the list of flags:

  • transientConnection

    The specified node name or address can be reached via a transient connection, such as PPP.

  • reachable

    The specified node name or address can be reached using the current network configuration.

  • connectionRequired

    The specified node name or address can be reached using the current network configuration, but a connection must first be established. If this flag is set, the kSCNetworkReachabilityFlagsConnectionOnTraffic flag, kSCNetworkReachabilityFlagsConnectionOnDemand flag, or kSCNetworkReachabilityFlagsIsWWAN flag is also typically set to indicate the type of connection required. If the user must manually make the connection, the kSCNetworkReachabilityFlagsInterventionRequired flag is also set.

  • connectionOnTraffic

    The specified node name or address can be reached using the current network configuration, but a connection must first be established. Any traffic directed to the specified name or address will initiate the connection.

  • interventionRequired

    The specified node name or address can be reached using the current network configuration, but a connection must first be established.

  • connectionOnDemand

    The specified node name or address can be reached using the current network configuration, but a connection must first be established. The connection will be established “On Demand” by the CFSocketStream programming interface (see CFStream Socket Additions for information on this). Other functions will not establish the connection.

  • isLocalAddress

    The specified node name or address is one that is associated with a network interface on the current system.

  • isDirect

    Network traffic to the specified node name or address will not go through a gateway, but is routed directly to one of the interfaces in the system.

  • isWWAN

    The specified node name or address can be reached via a cellular connection, such as EDGE or GPRS.

  • connectionAutomatic

    The specified node name or address can be reached using the current network configuration, but a connection must first be established. Any traffic directed to the specified name or address will initiate the connection. This flag is a synonym for


We can easily read these flags using the function SCNetworkReachabilityGetFlags
which wants two parameters:

– A SCNetworkReachability

– An empty SCNetworkReachabilityFlags
object passed by reference—in this way the internal implementation of SCNetworkReachabilityGetFlags
adds the flags to this object.

var flags = SCNetworkReachabilityFlags()
SCNetworkReachabilityGetFlags(reachability!, &flags)
// Now `flags` has the right data set by `SCNetworkReachabilityGetFlags`

Then, since flags
is a Set, we can check if a flag is available with the method contains

let isReachable: Bool = flags.contains(.reachable)

Using Synchronously

At this point, we have an instance of SCNetworkReachability
and we know how to read the flags. We are ready to check if the user’s device has internet connection.

To get this information, we can read the content of SCNetworkReachabilityFlags
with the following method:

func isNetworkReachable(with flags: SCNetworkReachabilityFlags) -> Bool {
    let isReachable = flags.contains(.reachable)
    let needsConnection = flags.contains(.connectionRequired)
    let canConnectAutomatically = flags.contains(.connectionOnDemand) || flags.contains(.connectionOnTraffic)
    let canConnectWithoutUserInteraction = canConnectAutomatically && !flags.contains(.interventionRequired)
    return isReachable && (!needsConnection || canConnectWithoutUserInteraction)

If you have some doubts about the meaning of some flags, you can check the flags list in.

And we can use the function above like this:

// Optional binding since `SCNetworkReachabilityCreateWithName` return an optional object
guard let reachability = SCNetworkReachabilityCreateWithName(nil, "") else { return }
var flags = SCNetworkReachabilityFlags()
SCNetworkReachabilityGetFlags(reachability, &flags)
if !isNetworkReachable(with: flags) {
    // Device doesn't have internet connection
#if os(iOS)
    // It's available just for iOS because it's checking if the device is using mobile data
    if flags.contains(.isWWAN) {
        // Device is using mobile data
// At this point we are sure that the device is using Wifi since it's online and without using mobile data

The example above is completely synchronous. This means that we don’t have to wait any completion handler to get the information which we’re looking for.

Using Asynchronously

There are applications where the synchronous information is not enough. We may need an asynchronous callback which says when the network state is changed.

Fortunately, SCNetworkReachability
provides the possibility to set a listener of network changes. We can achieve it with the following example:

class Handler {
    private let reachability = SCNetworkReachabilityCreateWithName(nil, "")
    // Queue where the `SCNetworkReachability` callbacks run
    private let queue = DispatchQueue.main
    // We use it to keep a backup of the last flags read.
    private var currentReachabilityFlags: SCNetworkReachabilityFlags?
    // Flag used to avoid starting listening if we are already listening
    private var isListening = false
    // Starts listening
    func start() {
        // Checks if we are already listening
        guard !isListening else { return }
        // Optional binding since `SCNetworkReachabilityCreateWithName` returns an optional object
        guard let reachability = reachability else { return }
        // Creates a context
        var context = SCNetworkReachabilityContext(version: 0, info: nil, retain: nil, release: nil, copyDescription: nil)
        // Sets `self` as listener object = UnsafeMutableRawPointer(Unmanaged.passUnretained(self).toOpaque())
        let callbackClosure: SCNetworkReachabilityCallBack? = {
            (reachability:SCNetworkReachability, flags: SCNetworkReachabilityFlags, info: UnsafeMutableRawPointer?) in
            guard let info = info else { return }
            // Gets the `Handler` object from the context info
            let handler = Unmanaged.fromOpaque(info).takeUnretainedValue()
            DispatchQueue.main.async {
                handler.checkReachability(flags: flags)
        // Registers the callback. `callbackClosure` is the closure where we manage the callback implementation
        if !SCNetworkReachabilitySetCallback(reachability, callbackClosure, &context) {
            // Not able to set the callback
        // Sets the dispatch queue which is `DispatchQueue.main` for this example. It can be also a background queue
        if !SCNetworkReachabilitySetDispatchQueue(reachability, queue) {
            // Not able to set the queue
        // Runs the first time to set the current flags
        queue.async {
            // Resets the flags stored, in this way `checkReachability` will set the new ones
            self.currentReachabilityFlags = nil
            // Reads the new flags
            var flags = SCNetworkReachabilityFlags()
            SCNetworkReachabilityGetFlags(reachability, &flags)
            self.checkReachability(flags: flags)
        isListening = true
    // Called inside `callbackClosure`
    private func checkReachability(flags: SCNetworkReachabilityFlags) {
        if currentReachabilityFlags != flags {
            // :rotating_light: Network state is changed :rotating_light:
            // Stores the new flags
            currentReachabilityFlags = flags
    // Stops listening
    func stop() {
        // Skips if we are not listening
        // Optional binding since `SCNetworkReachabilityCreateWithName` returns an optional object
        guard isListening,
            let reachability = reachability
            else { return }
        // Remove callback and dispatch queue
        SCNetworkReachabilitySetCallback(reachability, nil, nil)
        SCNetworkReachabilitySetDispatchQueue(reachability, nil)
        isListening = false

Thanks to Handler
class we can start/stop listening with the methods start
/ stop


To keep this example as plain as possible, checkReachability(flags:)
doesn’t check if the network is reachable but just if the flags are changed. In a real scenario, we may want to check also if the device has an internet connection using the method isNetworkReachable
used in“Using Synchronously”.

Avoiding Manual Implementation

If we want to avoid bothering ourself making a manual implementation, we can use an open source library which provides a high-level interface to wrap SCNetworkReachability

The most famous are:

iOS 11+

An example where we should use the network reachability may be an App which reads some informations from a public API. If the user’s device doesn’t have internet connection, trying to fetch the data doesn’t make sense. Instead, we should listen the network state changes and start fetching the data once we receive the notification that the device has internet connection available.

With iOS 11, Apple introduced the property waitsForConnectivity
in the URLSessionConfiguration
to wait an internet connection before performing any network activity with

. This means that, with this property set to true
we don’t need to bother ourself checking manually the device’s connection and waiting a valid internet connection. URLSession
will do it under the hood.

Unfortunately, if we have to support also versions older than iOS 11—or if we perform network activities without using URLSession
—we must continue doing it manually.


Most of the apps which we develop have to use an internet connection to transfer data. Therefore, we should handle properly the reachability state of the user’s device—to understand if we can perform or postpone some actions handling the missing connection. It can improve battery life and user experience.


To write this article, I used the implementation of both my Alamofire Pull Request
and the open source Library Reachability.swift

Marco Santarossa稿源:Marco Santarossa (源链) | 关于 | 阅读提示

本站遵循[CC BY-NC-SA 4.0]。如您有版权、意见投诉等问题,请通过eMail联系我们处理。
酷辣虫 » 综合技术 » Network Reachability With Swift

喜欢 (0)or分享给?

专业 x 专注 x 聚合 x 分享 CC BY-NC-SA 4.0

使用声明 | 英豪名录