Skip to main content

Click Web Element

Command description

Click a specified web element. The command activates the element's webpage and scrolls the element into view if necessary. Capture the element first, then choose the click mechanism, mouse button, and single- or double-click behavior.

Command Input Parameters

input parametersInput parameter typeDescription
Webpage ObjectWebPageClick an element on this page
Web ElementWebElement or str (captured element UID, not element name, not ms-rpa-id)Select a captured element or one returned by Get Web Element, Get Similar Web Elements, or Get Related Web Elements
Click TypeenumMouse Click, Silent Click, CDP Silent Click
Click MethodenumSingle Click, Double Click
Mouse ButtonenumLeft Button, Right Button
Click PositionenumRandom, Center
Modifier KeyenumNone, Alt, Ctrl, Shift
Post-Click DelaynumberTime to wait after clicking, in seconds
Element Wait DurationnumberMaximum time to wait for the element to appear, in seconds

Command Output Parameters

None

Type definition reference

Click method comparison

Click methodHow it worksUses the mouseSimilarity to human inputClick speedClick accuracyAdvantagesDisadvantages
Mouse ClickBrings the browser forward, locates the element on screen, moves the pointer, and clicksYes
Closest to a physical mouse click and broadly compatibleTakes control of the mouse and foreground window. The browser must be visible and the element unobstructed
Silent ClickDispatches the click through webpage JavaScriptNo
Fast, accurate, and fully background-capable, including when the browser is off-screen or covered by another windowSome webpage elements do not respond because it differs from a physical click
CDP Silent ClickLocates the element in the webpage, then clicks through Chrome CDPNo
Fast, close to a physical click, and background-capable even when the window is off-screen or covered by another windowThe target element cannot be covered by another webpage element
tip
  • Install the Runavelo browser extension before using this command.
  • CDP Silent Click requires Runavelo 7.7.0 or later and browser extension 2.4.0 or later.
  • See Capture Web Elements .

Example

FAQ

See Web Automation FAQ