Clearing up after subscribing to Swift WebSockets

Opening and keeping a WebSocket connection alive isn't enough when dealing with it. The connection needs to be closed either from user or sever side. That is mentioned in the official WebSocket protocol.

Previously we have seen how to implement WebSockets using Starscream library, URLSessionWebSocketTask and GraphQL in Swift projects. This time we will look into cleaning up the connection after you don’t need it anymore.

If you leave the connection open and don’t clean up properly various problems can arise: memory leaks, server overworking and data corruptions.

Closing the WebSocket

As we are looking at how to close connection from user agent there are couple of things to consider. When closing the connection we need to inform server about the reason using "close" code which can be useful for server developers. There are several "close" codes which you can check out in RFC 6455 specification or simplified version here.

If anything goes wrong with the connection on user side connection should be closed. It is important to note that when user agent notices that server has closed its connection, it should do the same on the other side. That means you need to explicitly inform the server about such event (regardless of the closure on the user side). That is clearly stated in the official WebSocket protocol.

Cancel the URLSessionWebSocketTask

To cancel a URLSessionWebSocketTask you need to call a cancel method.

When calling this instance method you need to provide a close code and a reason.

let url = URL(string: "wss://")!
let webSocketTask = URLSession.shared.webSocketTask(with: url)

// ...

webSocketTask.cancel(with: .goingAway, reason: nil)

Disconnect with Starscream

To close a WebSocket created with library Starscream you need to call a disconnect method. If you want to specify it in the close code you can do so, but it is optional.

let socket = WebSocket(url: URL(string: "ws://localhost:8080/")!)

// ...

socket.disconnect(closeCode: CloseCode.normal.rawValue)

Cancel subscriptions with GraphQL

When using GraphQL with subscriptions Apollo protocol handles all the heavy duty work behind the scenes. Clients can get immediate data changes from the server.

In Apollo iOS SDK library subscriptions are Cancellable protocol types. It is an object that can be cancelled when in progress and it has just one method cancel.

In order to clean up after GraphQL subscriptions are not needed anymore the easiest way is to keep track of all subscriptions and cancel when needed or do the cleanup within object deinit method.

var subscriptions: [Cancellable]

// ...

let newPricesSubcriprion = ApolloClient.subscribe(NewPricesSubscription()) { ... }

// ...

subscriptions.forEach { subscription in


When working with WebSockets we need to remember to close connections and clean up. Forgetting to do so we can run into multiple issues which can later be hard to debug and understand.

We can use WebSockets in our Swift projects in multiple ways and each one requires a different approach to close the connection. But most importantly as WebSocket protocol tells us we need to do it either connection is closed from the user or server side.