The ultimate guide to iOS Unit Testing with Swift and Xcode

Xcode Testing

29 Jun 2020 . 2 min read       @gurjitpt

Unit testing is a testing method where you can test “unit” of code whether it is working as you want or not. In Xcode, use XCTest framework to perform unit tests.

Unit test is a function starts with lowercase word "test” and it must be method of subclass of XCTestCase . It has conditions to check code is doing right as expected, but it has no parameters and no return value.

How to setup unit testing

Because units tests are perform under unit testing target you must have to add them before use. You can include “Unit Testing Bundle” in Xcode project two ways :

After setup it will generate new subclass of XCTestCase in your project inside testing folder which you can find inside Project navigator.

import XCTest

class XCArticleTests: XCTestCase {

   override func setUp() {
     // method is called before each test method
     // setup code here
   override func tearDown() {
     // method is called after each test method in the
     // code to perform cleanup
   func testExample() { 
     // add test case.
     // Use XCTAssert to test code

This example defines XCArticleTests which is a subclass of XCTestCase . It has three methods setUp() for initial setup, tearDown() to perform cleanup after execution and test method called testExample to perform all tests. If you want to read more about setup and teardown methods go to set up and tear down state in your tests article

How to write unit tests

Define new extension of type Int with a function called cubed which returns cube number.

extension Int {
   func cubed() -> Int {
      return self * self * self

Define new XCTestCase subclass CubeNumberTests with a method named testCubeNumber(). This method creates two properties one is number and another for cubeNumber and checks cubeNumber equals to 125.

class CubeNumberTests: XCTestCase {
    func testCubeNumber() {
       let number = 5
       let cubeNumber = number.cubed()
       XCTAssertEqual(cubeNumber, 125)

Click on gray diamond button on the left side next to test method. The diamond turns into green if test passes or otherwise it will give error message. The above test will be succeed because cube number of 5 matches 125.


Unit testing is a necessary skill if you want to be a good developer. It look hard in the beginning but it gets easier as you use them. Don’t use unit tests all over your application it will be confusing and time wasting .You should use them when it’s too necessary.

Don’t hesitate to contact me if you have any questions or queries. Follow me on twitter @gurjitpt for any updates.


Share this article

Generic placeholder image


Gurjit Singh

I’m Computer Science graduate and an iOS Engineer who writes about Swift and iOS development. Follow me on twitter @gurjitpt for more updates.

Next Posts

How to use enum in Swift Empty space for void

Enumerations (enum) enables you to write code in a type safe way. Enum is very useful while defining common type of values. You don't have to provide...

Mar 7, 2023 . 2 min read     Swift Enum

Read More »

Optional unwrapping syntax in Swift 5.7 Empty space for void

Optional unwrapping is one of the most used patterns in iOS development. Swift 5.7 introduces new features included a new way to unwrap optional values...

Jun 14, 2022 . 2 min read     Optional unwrapping

Read More »

Property observers in Swift Empty space for void

It's a common pattern or technique in various programming languages when we want to perform some action when a value is changed. Property ...

May 24, 2021 . 2 min read     Property Observers

Read More »