Genzbots
~4 min5 / 14

Browser Activities

Browser activities use Playwright under the hood to drive Chrome, Edge, and Firefox. They support modern web automation: tab management, dialog handling, file uploads/downloads, drag & drop, JavaScript execution, and screenshot capture. All browser activities can share a session via Browser Session ID.

Click ElementClickElement

Click a web page element using a CSS or XPath selector.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS selector (e.g., #submit, .btn-primary) or XPath (e.g., //button[text()='Submit'])
WaitForReadyBooleanNoTrueWait for the element to be ready before clicking.
InputMethodstringNoPlaywrightHow the click is dispatched: Playwright (native interaction), JavaScript (el.click()), or DOMEvent (dispatchEvent). Allowed: Playwright, JavaScript, DOMEvent
ClickTypestringNoSingleType of click to perform. Allowed: Single, Double
MouseButtonstringNoLeftMouse button to use. Allowed: Left, Right, Middle
ActivateBooleanNoFalseBring the browser window to the foreground before clicking.
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Close BrowserCloseBrowser

Close the browser and end the browser session.

ParameterTypeRequiredDefaultDescription
BrowserSessionIdstringNo—Browser session ID to close (auto-detected if omitted)

Execute JavaScriptExecuteJavaScript

Execute JavaScript code in the context of the current browser page.

ParameterTypeRequiredDefaultDescription
ScriptstringYes—JavaScript code to execute in the page context
ResultstringNo—Variable to store the script return value
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Extract Web TableExtractWebTable

Extract data from a web table into a DataTable variable.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS/XPath selector for the table, row, or cell element.
RowSelectorstringNotrCSS selector for rows inside the table (e.g., tr, tbody tr).
CellSelectorstringNotd,thCSS selector for row cells (e.g., td, th, td.cell-class).
HeaderSelectorstringNothCSS selector for header cells used as DataTable column names.
IncludeHeaderRowBooleanNoFalseWhen true, the detected header row is also kept as first data row.
RowIndexInt32No-1Extract a single data row by zero-based index. Use -1 for all rows.
ColumnIndexInt32No-1Extract a single column by zero-based index. Use -1 for all columns.
OutputVariablestringYes—Variable name to store the extracted DataTable.
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted).

Get Element TextGetElementText

Get the text content of a web page element using a CSS or XPath selector.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS or XPath selector for the element
OutputVariablestringNo—Variable to store the extracted text
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Hover ElementHoverElement

Hover the mouse over a web element to trigger hover effects or tooltips.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS or XPath selector for the element to hover over
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Launch BrowserLaunch Browser

Launch a browser. Child activities execute within this browser scope.

ParameterTypeRequiredDefaultDescription
SelectorstringNo—Application-level selector to identify the browser window
UrlstringNo—The URL to navigate to
BrowserTypestringNoChromeBrowser engine to use Allowed: Chrome, Chromium, Firefox, Webkit, Edge
OpenBooleanNoFalseAlways open a new browser instance (otherwise reuse existing session).
CloseBooleanNoTrueClose browser after completing child activities.
MaximizeWindowBooleanNoFalseMaximize the browser window after launch.
WaitForReadyBooleanNoTrueWait for the browser page to be ready for input.
CdpPortInt32No0Chrome DevTools Protocol port for attaching to an existing browser. 0 = auto-discover (tries 9222-9224). The browser must be launched with --remote-debugging-port=.
BrowserSessionIdInputstringNo—Browser session ID to reuse when Open is false
BrowserSessionIdOutputstringNobrowserSessionVariable to store the resolved browser session ID

Select OptionSelectOption

Select an option from a dropdown or select element by value, label, or index.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS or XPath selector for the select/dropdown element
ValuestringYes—The value, label, or index to select
SelectBystringNovalueHow to match the option: value, label, or index Allowed: value, label, index
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Take ScreenshotTakeScreenshot

Capture a screenshot of the current page or a specific element.

ParameterTypeRequiredDefaultDescription
FilePathstringYes—Folder where the screenshot will be saved (auto-named: Screenshot_ddmmyyyy_hhmm.png)
OutputPathstringNo—Variable to store the full screenshot file path
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Type Into ElementTypeIntoElement

Type text into a web page input field using a CSS or XPath selector.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS selector (e.g., #email, .input-field) or XPath for the input element
TextstringYes—Text to type into the element
InputMethodstringNoSimulateSimulate fills instantly; SendKeys types key-by-key. Allowed: Simulate, SendKeys
ClearBeforeBooleanNoFalseClear existing text before typing.
DelayBetweenKeysintNo0Delay in milliseconds between each keystroke (SendKeys mode).
ActivateBooleanNoFalseBring the browser window to the foreground before typing.
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)

Wait For Web ElementWaitForWebElement

Wait until a web element matching the selector becomes visible on the page.

ParameterTypeRequiredDefaultDescription
SelectorstringYes—CSS or XPath selector for the element to wait for
StatestringNoAppearElement state to wait for. Allowed: Appear, Disappear, Visible, Enabled, Exists, Clickable
ElementFoundboolNo—Variable to store whether element was found
BrowserSessionIdstringNo—Browser session ID (auto-detected if omitted)
Was this helpful?
UI AutomationExcel