click

Primary mouse click. Provide exactly one of on, css, coords, or x/y. The simplified form takes a single string description.

Parameters

Parameter	Type	Required	Description
`on`	`string`	No	Natural-language description of the click target.
`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.
`offset`	`string \| { x, y }`	No	Pixel offset from the resolved target. Either an `x, y` string or a `{ x, y }` object.
`times`	`number`	No	Number of times to click. Must be >= 1.
`waitForDownload`	`boolean`	No	Wait for a download to start after the click.
`delay`	`number`	No	Milliseconds to hold between mousedown and mouseup.
`downloadTimeout`	`number`	No	Maximum time in milliseconds to wait for a download.
`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.

Target description as a single string.

- click: the GB regression test menu item

- click:
    on: "the module card showing 'Module: testing-copilot'"
    waitForDownload: false
    retries: 2

- click:
    on: the button to download as zip
    waitForDownload: true
    saveAs: DOWNLOADED_FILE

- click:
    css: '[data-pendo-tracking="invoice-workspace-menu"]'

- click:
    on: the click here button
    iframe: https://example.com/checkout-widget

- click:
    coords: 0, 0

- click:
    on: the lucide save button in the top toolbar even if it is disabled
    force: true