Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nalexn/ViewInspector
Runtime introspection and unit testing of SwiftUI views
https://github.com/nalexn/ViewInspector
best-practices runtime-typechecking swift swift5 swiftui swiftui-views unit-testing
Last synced: about 1 month ago
JSON representation
Runtime introspection and unit testing of SwiftUI views
- Host: GitHub
- URL: https://github.com/nalexn/ViewInspector
- Owner: nalexn
- License: mit
- Created: 2019-11-16T13:19:44.000Z (almost 5 years ago)
- Default Branch: 0.10.0
- Last Pushed: 2024-08-03T19:27:24.000Z (about 2 months ago)
- Last Synced: 2024-08-03T20:37:55.431Z (about 2 months ago)
- Topics: best-practices, runtime-typechecking, swift, swift5, swiftui, swiftui-views, unit-testing
- Language: Swift
- Homepage:
- Size: 1.75 MB
- Stars: 2,112
- Watchers: 32
- Forks: 148
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - ViewInspector - Runtime inspection and unit testing of SwiftUI views (Testing / UI Testing)
- awesome-swiftui-libraries - ViewInspector - Runtime introspection and unit testing of SwiftUI views (Unit-testing / Content)
- awesome-swiftui - nalexn/ViewInspector - Runtime inspection and unit testing of SwiftUI views (Samples)
- awesome-ios - ViewInspector
- awesome-swiftui - ViewInspector - Runtime inspection and unit testing of SwiftUI views (Libraries / Inspection)
- awesome-ios-star - ViewInspector - Runtime inspection and unit testing of SwiftUI views (Testing / UI Testing)
- awesome-swiftui - ViewInspector
- fucking-about-SwiftUI - ViewInspector
README
ViewInspector 🕵️♂️ for SwiftUI
 [](https://travis-ci.com/nalexn/ViewInspector) [](https://codecov.io/gh/nalexn/ViewInspector)
**ViewInspector** is a library for unit testing SwiftUI views.
It allows for traversing a view hierarchy at runtime providing direct access to the underlying `View` structs.
## Why?
SwiftUI view is a function of state. We could provide it with the input, but were unable to verify the output... Until now!
## Helpful links
* **[Inspection guide](guide.md)**
* **[SwiftUI API coverage](readiness.md)**
## Use cases
### 1. Search the view of a specific type or condition
Use one of the `find` functions to quickly locate a specific view or assert there are none of such:
```swift
try sut.inspect().find(button: "Back")
try sut.inspect().findAll(ViewType.Text.self,
where: { try $0.attributes().isBold() })
```
Check out [this section](guide.md#dynamic-query-with-find) in the guide for the reference.
### 2. Read the inner state of the standard views
Standard SwiftUI views are no longer a black box:
```swift
let sut = Text("Completed by \(72.51, specifier: "%.1f")%").font(.caption)
let string = try sut.inspect().text().string(locale: Locale(identifier: "es"))
XCTAssertEqual(string, "Completado por 72,5%")
XCTAssertEqual(try sut.inspect().text().attributes().font(), .caption)
```
Each view has its own set of inspectable parameters, you can refer to the [API coverage](readiness.md) document to see what's available for a particular SwiftUI view.
### 3. Verify your custom view's state
Obtain a copy of your custom view with actual state and references from the hierarchy of any depth:
```swift
let sut = try view.inspect().find(CustomView.self).actualView()
XCTAssertTrue(sut.viewModel.isUserLoggedIn)
```
The library can operate with various types of the view's state, such as `@Binding`, `@State`, `@ObservedObject` and `@EnvironmentObject`.
### 4. Trigger side effects
You can simulate user interaction by programmatically triggering system-controls callbacks:
```swift
try sut.inspect().find(button: "Close").tap()
let list = try view.inspect().list()
try list[5].view(RowItemView.self).callOnAppear()
```
The library provides helpers for writing asynchronous tests for views with callbacks.
## FAQs
### Which views and modifiers are supported?
Check out the [API coverage](readiness.md). There is currently almost full support for SwiftUI v1 API, the v2 and v3 support is under active development.
### Is it using private APIs?
**ViewInspector** is using official Swift reflection API to dissect the view structures. So it'll be production-friendly even if you could somehow ship the test target to the production.
### How do I add it to my Xcode project?
Assure you're adding the framework to your unit-test target. **Do NOT** add it to the main build target.
#### Swift Package Manager
`https://github.com/nalexn/ViewInspector`
#### Carthage
`github "nalexn/ViewInspector"`
#### CocoaPods
`pod 'ViewInspector'`
### How do I use it in my project?
Please refer to the [Inspection guide](guide.md). You can also check out my other [project](https://github.com/nalexn/clean-architecture-swiftui) that harnesses the **ViewInspector** for testing the entire UI.
### Other questions, concerns or suggestions?
Ping me on [Twitter](https://twitter.com/nallexn) or just submit an issue or a pull request on Github.
---
[](https://nalexn.github.io/?utm_source=nalexn_github) [](https://venmo.com/nallexn)