---
title: OnScreenEntityExpectationBuilder
framework: Siri Evaluations
role: symbol
role_heading: Enumeration
platforms: [iOS 27.3+, iPadOS 27.3+, macOS 27.3+, visionOS 27.3+]
path: sirievaluations/onscreenentityexpectationbuilder
---

# OnScreenEntityExpectationBuilder

A result builder that collects the entities an onscreen expectation requires.

## Declaration

```swift
@resultBuilder enum OnScreenEntityExpectationBuilder
```

## Overview

Overview Restricted to ResolvableAppEntityExpectation, unlike EntityFindExpectationBuilder: a bare AppEntityDefinition (any instance of the type) or EventEntity.expectIdentifier("…") (a specific instance). A view is staged with entities the author already knows, so an onscreen expectation is identity-based; property-based .expect(title: …) does not compile here, by design.

## Topics

### Building results

- [buildArray(_:)](sirievaluations/onscreenentityexpectationbuilder/buildarray(_:).md)
- [buildBlock(_:)](sirievaluations/onscreenentityexpectationbuilder/buildblock(_:).md)
- [buildEither(first:)](sirievaluations/onscreenentityexpectationbuilder/buildeither(first:).md)
- [buildEither(second:)](sirievaluations/onscreenentityexpectationbuilder/buildeither(second:).md)
- [buildExpression(_:)](sirievaluations/onscreenentityexpectationbuilder/buildexpression(_:).md)
- [buildOptional(_:)](sirievaluations/onscreenentityexpectationbuilder/buildoptional(_:).md)

## See Also

### Creating an onscreen expectation

- [init(_:)](sirievaluations/onscreen/init(_:).md)
