Use AI to locate an element on a web page and then performs an assertion on it. This step is useful for verifying that the element’s content, attributes, or state are as expected.

Assertion types:

  • Content: Verify the text content of an element.
  • Attribute: Verify the value of an attribute on an element.
  • State:Verify the state of an element, such as whether it is visible or enabled.

Inputs

Description
string
required

Description of the element you want to assert on.

Configs

Timeout
number

Maximum number of seconds for the action to finish. If unset, defaults to the smart waiting timeout, which is configurable in test options and defaults to 5 seconds. The actual amount of time this step takes may be slightly greater than the timeout due to AI model latency.

Disable stability checks
boolean
default:false

Do not wait for the element to be visible, stable and actionable before interacting. Useful for elements that are constantly animating or partially obscured.

Use CSS selector
boolean
default:false

Treat the element description as a CSS selector. This is not recommended for maintainability reasons but can be useful for dynamic pages.

Disable caching
boolean
default:false

Disable caching for this step. Useful for elements that should always be located dynamically, such as table rows, search results, or graph nodes that may be re-ordered.

Act within iframe
string

Specify an exact URL or a regex to match the URL of the iframe in which the element is located. The provided matcher must match exactly one iframe element on the page. To provide a custom regex, use the /<regex-here>/ format.