---
title: IntentValueExpectation
framework: appintentstesting
role: symbol
role_heading: Protocol
platforms: [iOS 27.3+, iPadOS 27.3+, Mac Catalyst 27.3+, macOS 27.3+, tvOS 27.3+, visionOS 27.3+, watchOS 27.3+]
path: appintentstesting/intentvalueexpectation
---

# IntentValueExpectation

A type that describes the value you expect for an intent parameter, an app entity property, or an intent result.

## Declaration

```swift
protocol IntentValueExpectation : Sendable
```

## Overview

Overview A value expectation states a requirement on a single value, such as a string that contains a substring, or a value that’s absent. Pass value expectations to expect and result(_:) to build entity and intent expectations, or check a value directly with isSatisfied(by:). Intent parameters accept only ResolvableIntentValueExpectation values; see expect. You get value expectations from the static members that the framework provides, such as contains(_:), isNil, and matches(_:requirement:), and from entity definitions and entity expectations. Don’t declare new conformances to this protocol. For example, check whether an entity from an intent result has a title that contains a substring: let event: AnyAppEntity = try result.value let expectation = eventEntityDefinition.expect(title: .contains("NASA")) let isSatisfied = try await expectation.isSatisfied(by: event)

## Topics

### Instance Methods

- [isSatisfied(by:)](appintentstesting/intentvalueexpectation/issatisfied(by:).md)

### Type Properties

- [isNil](appintentstesting/intentvalueexpectation/isnil.md)
- [notNil](appintentstesting/intentvalueexpectation/notnil.md)

### Type Methods

- [contains(_:)](appintentstesting/intentvalueexpectation/contains(_:).md)
- [contains(regex:)](appintentstesting/intentvalueexpectation/contains(regex:).md)
- [equals(_:)](appintentstesting/intentvalueexpectation/equals(_:).md)
- [matches(_:requirement:)](appintentstesting/intentvalueexpectation/matches(_:requirement:).md)

## Relationships

### Inherits From

- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

### Inherited By

- [AppEntityExpectationProviding](appintentstesting/appentityexpectationproviding.md)
- [ResolvableAppEntityExpectation](appintentstesting/resolvableappentityexpectation.md)
- [ResolvableIntentValueExpectation](appintentstesting/resolvableintentvalueexpectation.md)

### Conforming Types

- [AppEntityDefinition](appintentstesting/appentitydefinition.md)
- [AppEntityExpectation](appintentstesting/appentityexpectation.md)
- [AppEntityIdentifierExpectation](appintentstesting/appentityidentifierexpectation.md)
- [PredicateExpectation](appintentstesting/predicateexpectation.md)
- [PrimitiveExpectation](appintentstesting/primitiveexpectation.md)
