0Pricing
Swift Academy · Lesson

XCTestCase Setup, Teardown and Test Methods

Structuring test classes with setUp/tearDown and naming test methods.

XCTestCase Setup, Teardown and Test Methods is a free Swift Academy lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Swift Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

XCTestCase Basics

XCTestCase is the base class for all Swift unit tests. Each method starting with "test" is a test case.

import XCTest

final class MathTests: XCTestCase {
  func testAddition() {
    XCTAssertEqual(2 + 2, 4)
  }
}

setUp and tearDown

setUp() runs before each test. tearDown() runs after each test. Use them for shared state initialization and cleanup.

final class UserServiceTests: XCTestCase {
  var sut: UserService!
  override func setUp() {
    super.setUp()
    sut = UserService()
  }
  override func tearDown() {
    sut = nil
    super.tearDown()
  }
}

setUpWithError and tearDownWithError

Throwing variants of setUp/tearDown: if setup throws, the test is marked as failed automatically.

override func setUpWithError() throws {
  sut = try UserService(config: loadTestConfig())
}
override func tearDownWithError() throws {
  try sut.cleanup()
}

Class-Level Setup

class setUp() and class tearDown() run once before/after all tests in the class — useful for expensive shared resources.

final class DBTests: XCTestCase {
  static var db: TestDatabase!
  override class func setUp() {
    super.setUp()
    db = TestDatabase.inMemory()
  }
  override class func tearDown() {
    db.close()
    super.tearDown()
  }
}

Naming Test Methods

Name tests as test_methodName_condition_expectedResult for readability and clear failure messages.

func test_login_withValidCredentials_returnsUser() throws { ... }
func test_login_withInvalidPassword_throwsUnauthorized() throws { ... }

addTeardownBlock

Register per-test cleanup blocks inline without overriding tearDown.

func testCreateFile() throws {
  let url = FileManager.default.temporaryDirectory.appendingPathComponent("test.txt")
  addTeardownBlock { try? FileManager.default.removeItem(at: url) }
  // ... test
}

Disabling Tests

Prefix a test method with _ or comment it out to skip it. XCTest also supports skipping with XCTSkipIf.

func testExperimentalFeature() throws {
  try XCTSkipIf(ProcessInfo.processInfo.environment["CI"] != nil, "Skip on CI")
  // ... test
}

Test Methods Cannot Throw (before Xcode 16)

In earlier Xcode, test methods declared as throws propagate errors as test failures via XCTAssertNoThrow.

func testDecode() throws {
  let user = try JSONDecoder().decode(User.self, from: validJSON)
  XCTAssertEqual(user.name, "Alice")
}

Failing a Test Explicitly

Call XCTFail("reason") to force a test to fail with a descriptive message.

func testCallback() {
  var called = false
  service.doWork { called = true }
  if !called { XCTFail("Callback was never invoked") }
}

Test Plans

Xcode Test Plans let you run the same tests with different configurations (language, environment variables, sanitizers).

// File → New → Test Plan
// Add test targets and configure per-configuration env vars
// Useful for running localized UI tests or with Address Sanitizer

Parallel Testing

Enable parallel testing in Xcode scheme settings to run test classes concurrently and reduce total test time.

// Product → Scheme → Test → Options → Execute in parallel
// Each XCTestCase class runs in a separate process
// Ensure tests are independent and don't share global state

Quick Check

Which XCTestCase method runs once before all tests in the class (not before each individual test)?

Lesson Recap

Override setUp/tearDown (or throwing variants) for per-test setup/cleanup. Use class setUp/tearDown for once-per-class resources. Name tests descriptively. Use addTeardownBlock for inline cleanup and XCTSkipIf for conditional skipping.

Frequently asked questions

Is the “XCTestCase Setup, Teardown and Test Methods” lesson free?

Yes — the full text of “XCTestCase Setup, Teardown and Test Methods” is free to read here on the web, and the Swift Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Swift Academy course, upgrade to CoddyKit PRO.

What will I learn in “XCTestCase Setup, Teardown and Test Methods”?

Structuring test classes with setUp/tearDown and naming test methods. You practise Swift Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Swift Academy?

No prior experience is required. Swift Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “XCTestCase Setup, Teardown and Test Methods” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Swift Academy lesson?

Yes. Every Swift Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. XCTestCase Setup, Teardown and Test Methods
  2. XCTAssert Family and Throwing Assertions
  3. Protocol-Based Mocking and Dependency Injection
  4. Async Tests and Performance Measurement
← Back to Swift Academy