checkElementAttribute

Asserts a condition on an HTML attribute on the element. 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.
`name`	`string`	Yes	Attribute name (for attribute checks) or CSS property name (for style checks).
`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

- checkElementAttributeEquals:
    element: the badge
    name: data-slot # the attribute to read
    value: badge # the value it must equal

- checkElementAttributeEquals:
    element: username input
    name: value
    value: jeff@retool.com

- checkElementAttributeStartsWith:
    element: Soulèvement intégraliste link
    DANGEROUS_FORCE_DYNAMIC: true
    name: title
    value: Soulèvement # matches when the title starts with this

- checkElementAttributeDoesNotExist:
    element: the 'badge' badge
    name: non-existent

Notes

Aliases supported by this family:

Alias
`checkElementAttributeExists`
`checkElementAttributeDoesNotExist`
`checkElementAttributeContains`
`checkElementAttributeDoesNotContain`
`checkElementAttributeEquals`
`checkElementAttributeDoesNotEqual`
`checkElementAttributeStartsWith`
`checkElementAttributeDoesNotStartWith`

Overview

AI

Mouse

Keyboard

Form

Scroll

Navigation

Waits

Page checks

Element checks

Network

Storage

Authentication

Visual

Connectivity

Scripts

Control flow

checkElementAttribute

Parameters

Examples

Notes

​Parameters

​Examples

​Notes

​Related

Parameters

Examples

Notes

Related