checkElementName

Asserts a condition on the element’s tag name. 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

- checkElementNameEquals:
    element: submit button
    value: BUTTON # tag name, uppercased

- checkElementNameStartsWith:
    element: username input
    value: INPUT

- checkElementNameDoesNotEqual:
    element: username input
    value: posdtstal

Notes

Aliases supported by this family:

Alias
`checkElementNameExists`
`checkElementNameDoesNotExist`
`checkElementNameContains`
`checkElementNameDoesNotContain`
`checkElementNameEquals`
`checkElementNameDoesNotEqual`
`checkElementNameStartsWith`
`checkElementNameDoesNotStartWith`

Overview

AI

Mouse

Keyboard

Form

Scroll

Navigation

Waits

Page checks

Element checks

Network

Storage

Authentication

Visual

Connectivity

Scripts

Control flow

Parameters

Examples

Notes

​Parameters

​Examples

​Notes

​Related

Parameters

Examples

Notes

Related