Skip to main content

Click

Overview


Clicks an element on the page.

Input

Browser

NameRequiredDescription
Browser InstanceWhich browser instance to run against.
Target (Selector)A Selector string that targets a specific element on the web page.

Target Options

NameRequiredDescription
Match TypeMatch Text either behaves as Regex or a simple Contains text check.
Match TextMatches elements that either contain this or match the regex somewhere inside the selected element, possibly in a child or a descendant element.
Match Index (Nth)(Optional) Target the Nth instance of the element. Eg. For 2 of the same element, use an Index of 0 to match the First and 1 to match the Second.
Frame Target (Selector)(Optional) Specify a Frame Selector, for example to first target an iframe before the primary Target.

Click

Options

NameRequiredDescription
Number of ClicksHow many times you want to click the element. Default is 1.
Mouse ButtonWhich mouse button you want to click with. Default is Left.
Timeout (ms)How long to wait in milliseconds for a successful click. Default is 30s.
Trial RunIf enabled this Click Action will only auto-wait for the element to be ready, it will not click.

Advanced Options

NameRequiredDescription
Click Release Delay (ms)How long to wait in milliseconds after clicking to release the mouse button.
Force ClickForces the click, overriding the auto-wait checks that make sure the element is ready to be clicked. The opposite of Trial Run.
Keyboard ModifiersA list of additional modifier keys to hold down while clicking.

Custom Position

NameRequiredDescription
EnabledIf enabled, your custom X,Y positions will be taken into account.
X PositionWhere to position horizontally relative to the top-left position.
Y PositionWhere to position vertically relative to the top-left position.
NameRequiredDescription
Prevent WaitEnable only if you must avoid waiting for navigation when it is required by certain web page actions to start their page loading, only required in exceptional situations like navigating to inaccessible pages.
Handle File PickerEnable only if this button click triggers a file picker popup window.
File to PushProvide the full file path to push into the file picker.
File Upload Timeout (ms)Timeout for file upload. Set to 0 for infinite wait.

Pop-up

Pop-up Options

NameRequiredDescription
Timeout (ms)How long to wait in milliseconds for a pop-up. Default is 0s (pop-up not expected).

Output

NameRequiredDescription
Action SuccessTrue if the action passed, false if it failed.
Browser PagePage from the action's browser instance.