checkElement - Momentic

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 alias table under Notes. Target the element by description or CSS selector. Coordinate targets are not supported.

Parameters

Parameter	Type	Required	Description
`element`	`string`	No	Natural-language description of the target. Use either `element` or `css`.
`css`	`string`	No	CSS selector for the target. Use instead of the description key.
`force`	`boolean`	No	Force the action even when the element is not actionable.
`iframe`	`string`	No	URL or URL pattern of the iframe that contains the target element.
`timeout`	`number`	No	Maximum time in milliseconds to wait for the condition to hold.
`DANGEROUS_FORCE_DYNAMIC`	`boolean`	No	Re-evaluate the step on every run, skipping the step cache.
`saveAs`	`string`	No	Name of the variable to write this step’s return value to.
`retries`	`number`	No	Number of times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Shorthand

When the alias takes no extra fields (e.g. Exists, Visible), the value can be a single target string.

- checkElementVisible: Save button

Examples

- checkElementVisible: the 'view code' button

- checkElementVisible:
    element: the Delayed action button
    timeout: 16000 # poll for up to 16s before failing

- checkElementVisible:
    element: the paragraph with the text about clicking the button from iframe 1
    iframe: https://example.com/iframe-1 # scope the lookup to this iframe

- checkElementEnabled:
    element: api key link
    timeout: 30000

- checkElementDoesNotExist:
    css: "#processing" # target by CSS selector instead of a description

- checkElementNotVisible:
    element: "{{ env.NON_PLAN }} column in the pricing table"
    DANGEROUS_FORCE_DYNAMIC: true # re-evaluate every run, skipping the step cache

- checkElementFocused: username input

- checkElementEditable: enabled input

Notes

Aliases supported by this family:

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

⌘I