> ## 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.

# checkElement

> Element-level assertion family for the element itself.

Asserts a condition on the element itself. 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.                         |
| `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.                           |

## Shorthand

Target as a single string.

```yaml theme={null}
- checkElementVisible: the Sign in button
```

## Examples

```yaml theme={null}
- checkElementVisible:
    on: the Submit button
    timeout: 16000 # poll for up to 16s before failing
```

```yaml theme={null}
- checkElementDoesNotExist: the loading spinner
```

## Notes

Aliases supported by this family:

| Alias                      |
| -------------------------- |
| `checkElementExists`       |
| `checkElementDoesNotExist` |
| `checkElementVisible`      |
| `checkElementNotVisible`   |
| `checkElementEnabled`      |
| `checkElementNotEnabled`   |
| `checkElementEditable`     |
| `checkElementNotEditable`  |
| `checkElementFocused`      |
| `checkElementNotFocused`   |

## Related

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