Overview

The CLICK step allows you to click on any element on the page. It automatically handles scrolling the element into view and validates that the element is clickable before attempting the click action.

Parameters

targetDescription
string
required
Element selector to click. Supports CSS selectors, XPath, and other selector formats.
pressEnter
boolean
default:"false"
Press Enter key after clicking the element

Behavior

  1. Element Location: Finds the element using the provided selector
  2. Visibility Check: Ensures the element is visible on the page
  3. Scroll Into View: Automatically scrolls the element into view if needed
  4. Clickability Validation: Verifies the element is enabled and clickable
  5. Click Action: Performs the click action
  6. Optional Enter Key: Presses Enter key if pressEnter is set to true

Common Use Cases

  • Clicking buttons to submit forms
  • Clicking links to navigate
  • Clicking checkboxes or radio buttons
  • Triggering dropdown menus
  • Interacting with any clickable UI element

Error Handling

The step will fail if:
  • The element cannot be found using the selector
  • The element is not visible
  • The element is disabled
  • The element is not clickable (e.g., covered by another element)
Clear error messages are provided to help debug selector or element state issues.