checkElementContent

Asserts a condition on the element’s text content. 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
`element`	`string`	No	Natural-language description of the target. Use exactly one of `element`, `css`, `coords`, or `x`/`y`.
`css`	`string`	No	CSS selector for the target. Use instead of the description key.
`coords`	`string \| { x, y }`	No	Absolute viewport coordinates. Either an `x, y` string (e.g. `120, 40`) or a `{ x, y }` object.
`x`	`number \| string`	No	X coordinate. Must be provided together with `y`.
`y`	`number \| string`	No	Y coordinate. Must be provided together with `x`.
`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.
`value`	`string`	Yes	Value to compare against. Required for every condition except `Exists` and `DoesNotExist`.
`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.

Examples

- checkElementContentEquals:
    element: the 'view code' button
    value: View Code

- checkElementContentEquals:
    element: sign in with google button
    value: "Sign in with Google "

- checkElementContentContains:
    element: the param_1 input showing default value
    timeout: 15000 # poll for up to 15s before failing
    value: option2

- checkElementContentContains:
    element: the in-progress menu item in the status menu
    value: In progress

Notes

Aliases supported by this family:

Alias
`checkElementContentExists`
`checkElementContentDoesNotExist`
`checkElementContentContains`
`checkElementContentDoesNotContain`
`checkElementContentEquals`
`checkElementContentDoesNotEqual`
`checkElementContentStartsWith`
`checkElementContentDoesNotStartWith`

Overview

AI

Mouse

Keyboard

Form

Scroll

Navigation

Waits

Page checks

Element checks

Network

Storage

Authentication

Visual

Connectivity

Scripts

Control flow

checkElementContent

Parameters

Examples

Notes

​Parameters

​Examples

​Notes

​Related

Parameters

Examples

Notes

Related