Click on the page

Clicks an element on a page, after waiting for it to be there and enabled.

Click selector on the page

Details #

Scrolls the element into view, waits up to timeout seconds (default 3) for it to exist and be enabled, then clicks it the way a mouse would: pointer events, then the click. button is left, right or middle; count is 1, 2 or 3; modifiers holds cmd, ctrl, opt, shift.

Without the extension it falls back to AppleScript for a plain CSS selector.

Parameters #

Parameter	Type	Required	Values	What it does
`selector`	text	Yes		Required.
`browser`	one of		`safari` `chrome` `front`
`button`	one of		`left` `right` `middle`	, count, modifiers.
`count`	number
`modifiers`	list of		`cmd` `ctrl` `opt` `shift`
`tab`	any value			, via.
`timeout`	number			Seconds to wait for the element.
`via`	one of		`auto` `extension` `appleScript`

Every step also accepts label, onFailure, timeout and dryRunSafe.

Examples #

Click Sign in

Click “text=Sign in” on the page

Open in Switchboard to try it

Gotchas #

Some sites ignore clicks a script makes; the click step with a locator sends a real one.