# LayoutElementAssertionsProvider

# LayoutElementAssertionsProvider

Artifact:[androidx.wear.protolayout:protolayout-testing](https://developer.android.com/jetpack/androidx/releases/wear-protolayout)  
[View Source](https://cs.android.com/search?q=file:androidx/wear/protolayout/testing/LayoutElementAssertionsProvider.kt+class:androidx.wear.protolayout.testing.LayoutElementAssertionsProvider)  
Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider "View this page in Java")

<br />

```
class LayoutElementAssertionsProvider
```

<br />

*** ** * ** ***

Provides the main entry point into testing by exposing methods to find a layout element.

## Summary

|                                                                                                                                                                                                   ### Public constructors                                                                                                                                                                                                    |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [LayoutElementAssertionsProvider](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider#LayoutElementAssertionsProvider(androidx.wear.protolayout.LayoutElementBuilders.Layout))`(layout: `[LayoutElementBuilders.Layout](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/LayoutElementBuilders.Layout)`)`                               |
| [LayoutElementAssertionsProvider](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider#LayoutElementAssertionsProvider(androidx.wear.protolayout.LayoutElementBuilders.LayoutElement))`(` ` layoutRoot: `[LayoutElementBuilders.LayoutElement](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/LayoutElementBuilders.LayoutElement) `)` |

|                                                                ### Public functions                                                                 |
|-----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [LayoutElementAssertion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertion)                   | [onElement](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider#onElement(androidx.wear.protolayout.testing.LayoutElementMatcher))`(matcher: `[LayoutElementMatcher](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementMatcher)`)` Finds an element that matches the given condition.                                                    |
| [LayoutElementAssertion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertion)                   | [onRoot](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider#onRoot())`()` Finds the top level element of the element tree added to this[LayoutElementAssertionsProvider](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider).                                                                                         |
| [LayoutElementAssertionsProvider](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider) | [withDynamicData](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider#withDynamicData(kotlin.Array))`(vararg dynamicDataPairs: `[DynamicDataPair](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicDataPair)`<*>)` Injects the app state and/or platform data for evaluating the dynamic data applied on the layout element under testing. |

## Public constructors

### LayoutElementAssertionsProvider

Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)  

```
LayoutElementAssertionsProvider(layout: LayoutElementBuilders.Layout)
```  

### LayoutElementAssertionsProvider

Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)  

```
LayoutElementAssertionsProvider(
    layoutRoot: LayoutElementBuilders.LayoutElement
)
```  

## Public functions

### onElement

Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)  

```
fun onElement(matcher: LayoutElementMatcher): LayoutElementAssertion
```

Finds an element that matches the given condition.  

### onRoot

Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)  

```
fun onRoot(): LayoutElementAssertion
```

Finds the top level element of the element tree added to this[LayoutElementAssertionsProvider](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/testing/LayoutElementAssertionsProvider).  

### withDynamicData

Added in[1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.3.0)  

```
fun withDynamicData(vararg dynamicDataPairs: DynamicDataPair<*>): LayoutElementAssertionsProvider
```

Injects the app state and/or platform data for evaluating the dynamic data applied on the layout element under testing.