Skip to main content
Go to the Studio
Browser

Checkbox

Checkbox

Ticks or unticks a checkbox on a web page. It works three ways: by CSS selector in the browser, on an element already captured, or on an element from a list.


Options​

Select the action​

The action's mode. What you pick here decides which of the other fields appear.

By browser​

Works with the checkbox using a CSS selector on the page.

Browser or page ID​

The browser, tab or iframe opening action used as the context.

Element selector​

The CSS selector identifying the checkbox, input#acceptTerms for example.

By element​

Works with a checkbox captured earlier by a Get element action.

Element ID​

The action that captured the checkbox element.

By element list​

Works with a checkbox from a list captured by a Get elements action.

Element list ID​

The action that captured the list.

The list index​

The checkbox's position in the list. The index starts at 0.

Tick or untick the checkbox​

Whether the checkbox ends up ticked or unticked. Default: tick.

Element state​

The condition the checkbox has to be in beforehand: Visible, Invisible/hidden, Present in the DOM or Not present in the DOM. Default: Visible.

Timeout​

How long, in seconds, the robot waits for the checkbox to be available before failing. Default: 120.

Returns​

Javascript code​

js
actions["action-id"] // the checkbox element worked with (Element)

Field selection​

The element can be referenced by other actions working in By element mode.

Rules and conditions​

  • Select the action has to be set before the other fields.
  • In By browser mode, the page ID and the CSS selector are both required.
  • The action sets the checkbox directly to the state you configured, whatever state the page had it in.
  • If the checkbox is not found within the timeout, the robot stops with an error.