assertVisually - Momentic

Accepts the same parameters as assert (that, timeout, iframe, saveAs, retries, skipped), but the agent reasons over a screenshot of the current viewport rather than the DOM (web) or accessibility/XML hierarchy (mobile). Use assertVisually when the condition is visual and fully inside the current viewport, for example an event block sitting in the 11:30-12:00 row of a calendar grid, or a detail inside a video frame or canvas drawing. Scroll the target into view if necessary before calling it; otherwise use assert.

Parameters

Parameter	Type	Required	Description
`that`	`string`	Yes	What must be true on the page, purely from the screenshot.
`timeout`	`number`	No	Maximum time in milliseconds to wait.
`iframe`	`string`	No	URL or URL pattern of the iframe that contains the target element.
`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

Assertion text as a single string.

- assertVisually: there is a twitter profile shown on the page

Examples

- assertVisually:
    that: |
      the module's two substeps (return 1 and return 2) both have green check
      marks to their left, but the top-level "return 3" step that comes after
      the module does NOT have a green check mark
    timeout: 60000

- assertVisually:
    that: |
      none of the step cards on the left-hand side of the editor have
      a green check mark next to them

On mobile, assertVisually evaluates the assertion from the screenshot only and skips capturing the accessibility/XML hierarchy. Reach for it when the screen is rendered in a way the hierarchy cannot describe (for example a WebView with multiple pages) or the condition is purely visual.

- assertVisually: the cart shows a red error banner above the checkout button

In browser tests, softAssertVisually accepts the same parameters but records an assertion failure and continues. It isn’t available on mobile. See the soft assertions guide for version requirements and stopping behavior.

​Parameters

​Shorthand

​Examples

​Related

Parameters

Shorthand

Examples

Related