How to do one-time setup for your tests

Paul Hudson    February 19th 2018    @twostraws

When you create a default XCTestCase using Xcode you’ll get default setUp() and tearDown() methods like these:

override func setUp() {
    super.setUp()
    // Put setup code here. This method is called before the invocation of each test method in the class.
}

override func tearDown() {
    // Put teardown code here. This method is called after the invocation of each test method in the class.
    super.tearDown()
}

Those are called before and after every test inside your XCTestCase subclass, which allows you to reset your testing environment fully. However, sometimes you prefer to do some setup once and keep that state during all your tests, for example if you need to generate some test data that gets shared in all your tests.

As well as the regular setUp() and tearDown() instance methods, you can also define class methods with the same names, like this:

override class func setUp() {
    super.setUp()
}

override class func tearDown() {
    super.tearDown()
}

Unlike their instance method equivalents, these two class methods will be run only once each: setUp() before all your tests are run, and tearDown() after all your tests have completed.

Available from iOS

Did this solution work for you? Please pass it on!

Tweet

Other people are reading…

• How to test asynchronous functions using expectation()
• How to test throwing functions
• How to write performance tests using measure()
• How to set baselines for your performance tests
• How to do conditional test tear down using addTeardownBlock()

About the Swift Knowledge Base

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