Как тестировать SwiftUI-представления?

Тестирование SwiftUI-представлений

SwiftUI-представления тестируются на трёх уровнях: unit-тесты бизнес-логики (ViewModel), snapshot-тесты внешнего вида и UI-тесты взаимодействия (XCUITest). Структуры-представления SwiftUI не инстанциируются напрямую в unit-тестах — они тесно связаны с циклом рендеринга.

Unit-тестирование ViewModel

Выносите логику в @Observable или ObservableObject классы и тестируйте их изолированно:

import XCTest
@testable import Talento

@Observable
final class JobListViewModel {
    var jobs: [Job] = []
    var isLoading = false
    var errorMessage: String?

    private let service: JobServiceProtocol

    init(service: JobServiceProtocol) {
        self.service = service
    }

    func loadJobs() async {
        isLoading = true
        do {
            jobs = try await service.fetchJobs()
        } catch {
            errorMessage = error.localizedDescription
        }
        isLoading = false
    }
}

final class JobListViewModelTests: XCTestCase {
    func test_loadJobs_populatesJobs() async {
        let mockService = MockJobService()
        mockService.stubbedJobs = [Job(title: "iOS Dev", company: "ACME")]
        let vm = JobListViewModel(service: mockService)

        await vm.loadJobs()

        XCTAssertEqual(vm.jobs.count, 1)
        XCTAssertFalse(vm.isLoading)
        XCTAssertNil(vm.errorMessage)
    }

    func test_loadJobs_onError_setsErrorMessage() async {
        let mockService = MockJobService()
        mockService.shouldThrow = true
        let vm = JobListViewModel(service: mockService)

        await vm.loadJobs()

        XCTAssertNotNil(vm.errorMessage)
    }
}

Snapshot-тестирование

Библиотека swift-snapshot-testing от Point-Free позволяет делать снимки SwiftUI-представлений и сравнивать с эталонами. Добавьте зависимость через Swift Package Manager: https://github.com/pointfreeco/swift-snapshot-testing.

import SnapshotTesting
import SwiftUI
import XCTest

final class JobCardSnapshotTests: XCTestCase {
    func test_jobCard_defaultState() {
        let view = JobCardView(
            title: "Senior iOS Developer",
            company: "ACME Corp",
            salary: "$5000"
        )
        let vc = UIHostingController(rootView: view)
        vc.view.frame = CGRect(x: 0, y: 0, width: 375, height: 120)

        assertSnapshot(of: vc, as: .image(on: .iPhone13Pro))
    }
}

UI-тестирование через XCUITest

XCUITest запускает приложение в симуляторе и взаимодействует через accessibility-дерево. Используйте .accessibilityIdentifier для надёжного поиска элементов:

// В представлении
TextField("Поиск", text: $query)
    .accessibilityIdentifier("searchField")

List(jobs) { job in
    Text(job.title)
        .accessibilityIdentifier("jobTitle_\(job.id)")
}

// В XCUITest
final class JobSearchUITests: XCTestCase {
    let app = XCUIApplication()

    override func setUpWithError() throws {
        continueAfterFailure = false
        app.launch()
    }

    func test_search_showsFilteredResults() {
        let searchField = app.textFields["searchField"]
        XCTAssertTrue(searchField.waitForExistence(timeout: 3))
        searchField.tap()
        searchField.typeText("Swift")
        // Проверяем, что список обновился
        XCTAssertTrue(app.staticTexts["iOS Developer"].waitForExistence(timeout: 2))
    }
}

Тестирование с PreviewProvider

Xcode Previews не являются автоматизированными тестами, но ускоряют ручную проверку визуальных состояний. Для автоматизации используйте snapshot-тесты.

Подводные камни

• SwiftUI-представления нельзя напрямую инстанциировать в unit-тестах и вызывать методы — тестируйте только ViewModel и логику.
• Снэпшот-тесты чувствительны к версии iOS и Xcode — при обновлении SDK все снимки нужно пересоздавать.
• XCUITest медленный: один тест занимает секунды, полный набор из 100 тестов — минуты. Не дублируйте unit-тесты как UI-тесты.
• Без accessibilityIdentifier тесты привязаны к локализованным строкам и ломаются при смене языка.
• Асинхронные операции в тестах требуют waitForExistence(timeout:) — без ожидания тест упадёт нестабильно (flaky).
• Mock-сервисы должны реализовывать протоколы — не подменяйте реальные зависимости через глобальные синглтоны, это делает тесты нестабильными.
• Тестирование SwiftData в юнит-тестах требует ModelConfiguration(isStoredInMemoryOnly: true) — иначе тесты будут читать/писать реальную базу.

• Сводить «тестировать SwiftUI-представления» к синтаксису и не объяснять environment.
• Игнорировать жизненный цикл, основной поток или момент освобождения ресурсов в сценарии swiftui-23.
• Выбирать API по привычке, не проверяя состояние, ошибки, доступность и платформенные ограничения.

• Формулирует точную модель для «тестировать SwiftUI-представления» и подтверждает ее корректным примером.
• Умеет связать ответ с main actor, тестированием и отладкой на устройстве.
• Называет ограничения подхода swiftui-23, включая производительность, память и сопровождение.