> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# checkElementName

> Element-level assertion family for the element's type name.

Asserts a condition on the element's type/class name. Each alias is its own
single-key command. There is no separate `condition` or `negated` field. The
positive and negative variants map directly to the table below.

## Parameters

| Parameter | Type      | Required  | Description                                                                                  |
| --------- | --------- | --------- | -------------------------------------------------------------------------------------------- |
| `on`      | `string`  | Yes       | Target description or percent pair.                                                          |
| `value`   | `string`  | Sometimes | Value to compare against. Required for every condition except `*Exists` and `*DoesNotExist`. |
| `timeout` | `number`  | No        | Milliseconds to wait for the condition to hold.                                              |
| `saveAs`  | `string`  | No        | Variable to store this step's return value on `env.<name>`.                                  |
| `retries` | `number`  | No        | Times to retry the step on failure before failing the test.                                  |
| `skipped` | `boolean` | No        | Skip this step at execution time.                                                            |

## Examples

```yaml theme={null}
- checkElementNameEquals:
    on: the submit button
    value: XCUIElementTypeButton # iOS element type
```

```yaml theme={null}
- checkElementNameStartsWith:
    on: the username field
    value: android.widget.EditText # Android class name
```

## Notes

Aliases supported by this family:

| Alias                              |
| ---------------------------------- |
| `checkElementNameExists`           |
| `checkElementNameDoesNotExist`     |
| `checkElementNameContains`         |
| `checkElementNameDoesNotContain`   |
| `checkElementNameEquals`           |
| `checkElementNameDoesNotEqual`     |
| `checkElementNameStartsWith`       |
| `checkElementNameDoesNotStartWith` |

## Related

* [Test format](/core-concepts/test-format)
