Click On Web Element Step
The Click On Web Element step makes your automation click a specific spot on a web page. Use it to click buttons, links, or anything else you'd normally click with a mouse.
How to Use Click On Web Element
Add this step to your process when you need to click something in a web browser.
Step 1: Add the Click On Web Element Step
- Drag the "Click On Web Element" step into your process workflow.
- Give the step a clear name in the "Step Name" field. This helps you find it later.
Step 2: Tell it What to Click
- Pick a Selector Type from the dropdown menu. This tells Robotiq.ai how to find the web element.
- Type in the Selector Value. This is the specific ID for the element, based on the type you picked.
Important: You can find these selector values by looking at the elements in your web browser's developer tools.
Step 3: Set Up the Click
- Choose the Click Type from the dropdown menu:
- Left Click
- Right Click
- If you need to double click, set the Double Click toggle to
T(true). It'sF(false) by default.
Step 4: Pick Driver and Timeout
- Enter the Driver Reference. This is the variable that holds your web browser.
- Set the Wait for Element until timeout [ms]. This is how long (in milliseconds) the step will wait for the element to show up before it gives up.
Parameters Explained
Step Name (Optional)
- A custom name for the step.
- Example:
Click Login Button - Use this to make your steps easy to understand.
Selector Type (Required)
- How Robotiq.ai finds the web element.
- Options:
Class Name,CSS Selector,Name,Id,Link Text,Partial Link Text,Tag Name,XPath - Pick the type that best identifies what you want to click.
Selector Value (Required)
- The specific value for the selector type you chose.
- Example: If
Selector TypeisId,Selector Valuemight beloginButton. - You can use an existing variable name or type in a direct value.
Click Type (Required)
- The kind of mouse click to do.
- Options:
Left Click,Right Click - Choose the standard left click for most things.
Double Click (Required)
- Says if it's a single or double click.
T(true): Does a double click.F(false): Does a single click (this is the default).
IFrame Selector Type (Optional)
- Defines how the iframe containing the target web element is identified.
- Options:
Class Name,CSS Selector,Name,Id,Link Text,Partial Link Text,Tag Name,XPath - Select the option that best identifies the iframe you want to interact with.
IFrame Selector Value (Optional)
- Specifies the value used to locate the iframe based on the selected IFrame Selector Type.
- Example: If IFrame Selector Type is
Id, the IFrame Selector Value could bepaymentIframe. - Use this when the element you want to interact with is located inside an iframe.
Driver Reference (Required)
- The variable that holds the web browser.
- Example:
myBrowserDriver - This links the click to a specific open browser.
Wait for Element until timeout [ms] (Required)
- The most time (in milliseconds) to wait for the element to load.
- Example:
5000(waits for 5 seconds) - Set a reasonable timeout so your processes don't fail too quickly.
Addditional Selectors (Optional)
- List of selectors, allowing you to define multiple selectors for the same step
- If the primary selector fails and additional selectors are defined, the step will automatically try the additional selectors in order.
- You can add, remove, and reorder selectors at any time.
- Any selector can be promoted to the primary selector, which will swap its position with the current primary selector.
- Each selector is evaluated for the duration of the timeout defined on the step before moving on to the next one.
- If you want to promote a selector to be the primary selector, first provide all required details (selector type and value), then click the swap icon next to selector type.
Related Articles
- Type Into Web Element Step - Learn how to type text into web elements.
- Read Text From Web Element Step - Learn how to get text from web elements.
- Record process - Find out how to record your browser actions to create steps automatically.
Need Help?
Can't find what you're looking for? Join the Robotiq Community to get help from other users and the Robotiq team.