NEW: Nominations are now open for the 2019 Swift Community Awards! >>

How to make a network request wait for an internet connection using waitsForConnectivity

Swift version: 5.1

Paul Hudson    @twostraws   

If you use URLSession to make a data task while the user has no internet connection, your request will fail immediately and report an error. However, if you create your session with the waitsForConnectivity configuration option set to true, then the system will automatically wait some time to see if connectivity becomes available before trying the request.

For example, this creates a data task that fetches a URL only when internet connectivity is available:

let config = URLSessionConfiguration.default
config.waitsForConnectivity = true

URLSession(configuration: config).dataTask(with: yourURL) { data, response, error in
    if let error = error {
    } ei

    // use your data here

By default, the system will wait seven days to see if internet connectivity becomes available, but you can control that with the timeoutIntervalForResource property on your configuration. For example, this will ask the system to wait 60 seconds:

config.timeoutIntervalForResource = 60

LEARN SWIFTUI FOR FREE I have a massive, free SwiftUI video collection on YouTube teaching you how to build complete apps with SwiftUI – check it out!

Available from iOS 11.0

Similar solutions…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Buy Testing Swift Buy Practical iOS 12 Buy Pro Swift Buy Swift Design Patterns Buy Swift Coding Challenges Buy Server-Side Swift (Vapor Edition) Buy Server-Side Swift (Kitura Edition) Buy Hacking with macOS Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with Swift Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Beyond Code

Was this page useful? Let us know!