Writing reliable Swift code starts with tests you can trust. This guide covers everything from the foundations of XCTest to modern Swift Testing patterns.

Table of Contents

1. What is XCTest and Why It Matters
2. Best Practices
3. What's New with Swift Testing

What is XCTest and Why It Matters

XCTest is Apple's native testing framework, bundled directly into Xcode and available across all Apple platforms — iOS, macOS, watchOS, tvOS, and visionOS. It has been the standard tool for unit testing Swift (and Objective-C) code since Xcode 5, and it remains the backbone of automated quality assurance in the Apple ecosystem.

The Core Purpose

At its heart, XCTest exists to let you verify that your code does exactly what you intend it to do — not just today, but after every future change. It serves several concrete goals:

• Catching regressions early. When you refactor a method or add a feature, your test suite runs in seconds and tells you if anything broke. Without tests, regressions hide until QA, beta testers, or — worst of all — users find them.
• Documenting behavior. A well-named test is executable documentation. testLoginFailsWithEmptyPassword() tells the next developer (or future you) exactly what the system is supposed to do without requiring them to read through implementation details.
• Enabling confident refactoring. Clean architecture requires refactoring. Refactoring without tests is risky. With solid test coverage, you can restructure internals freely, trusting the test suite to flag any behavioral changes.
• Driving design. Writing tests before or alongside implementation — Test-Driven Development (TDD) — forces you to think about your API from the caller's perspective. Code that is hard to test is usually poorly designed; tests act as a design pressure valve.

Anatomy of an XCTest Test Case

A test lives inside a class that inherits from XCTestCase. Each test method must start with the word test, take no arguments, and return void.

import XCTest
@testable import MyApp

final class CurrencyFormatterTests: XCTestCase {

    var formatter: CurrencyFormatter!

    // MARK: - Lifecycle

    override func setUp() {
        super.setUp()
        formatter = CurrencyFormatter(locale: Locale(identifier: "en_US"))
    }

    override func tearDown() {
        formatter = nil
        super.tearDown()
    }

    // MARK: - Tests

    func testFormatsPositiveAmountCorrectly() {
        let result = formatter.string(from: 1_234.56)
        XCTAssertEqual(result, "$1,234.56")
    }

    func testFormatsZeroAsZeroDollars() {
        let result = formatter.string(from: 0)
        XCTAssertEqual(result, "$0.00")
    }

    func testFormatsNegativeAmountWithMinusSign() {
        let result = formatter.string(from: -99.99)
        XCTAssertEqual(result, "-$99.99")
    }
}

The XCTest Assertion Toolkit

XCTest provides a rich set of assertion functions: