Skip to content

Page Action Nodes ​

Page Action nodes control browser tabs, open webpages, and interact with page elements. This guide covers all 17 RPA Page Action nodes.

Element nodes generally use a selector or saved element object. See Select a Location Method and Select a Matching Element.

Page Action nodes
Page Action nodes

Tab Nodes ​

New Tab ​

Opens a new tab in the active browser profile without business configuration. Subsequent page actions run in the new tab.

Close Tab ​

Closes the active tab. Before closing, confirm that downstream nodes do not need variables or element objects from the page.

Close Other Tabs ​

Keeps the active tab and closes other tabs in the same profile. Use it near workflow start to remove stale pages before subsequent tab switches.

Switch Tab ​

Finds and activates a target page by title or URL. For a page whose URL contains /download, select URL, Contains, and enter /download.

Switch Tab configuration
Switch Tab configuration
No.SettingDescription
1Match fieldSelect Title or URL
2Match methodSelect Equal, Not Equal, Contains, or Does Not Contain
3Match valueEnter the title or URL to find; variables are supported

If several tabs match, narrow the rule until it identifies one page. Continue with clicks or data reads after switching.

Target tab after switching
Target tab after switching

Access Website ​

Opens a URL. The URL field supports variables and has a default timeout of 10000ms.

Access Website configuration
Access Website configuration
No.SettingDescription
1URLEnter a complete address with its scheme; variables are supported
2TimeoutSet the page access timeout; the default is 10000ms

Increase the timeout for a slow response and use Wait for Element or Wait for Request afterward to confirm that content is ready.

Refresh Page ​

Reloads the active tab. Refreshing changes the DOM and can invalidate saved element objects. Locate elements again after refreshing.

Refresh Page configuration
Refresh Page configuration
No.SettingDescription
1TimeoutSet the refresh timeout; the default is 10000ms

Forward ​

Moves forward one page in browser history. If there is no forward entry, the tab does not navigate.

Forward configuration
Forward configuration
No.SettingDescription
1TimeoutSet the forward operation timeout; the default is 10000ms

Back ​

Moves back one page in browser history. Wait for key elements again before continuing.

Back configuration
Back configuration
No.SettingDescription
1TimeoutSet the back operation timeout; the default is 10000ms

Screenshot ​

Saves the active page as an image. The defaults are full page and png.

Screenshot node configuration
Screenshot node configuration
No.SettingDescription
1File nameEnter a variable-enabled name; leave blank to use the task and timestamp default
2Folder typeSelect the default folder or a local folder
3Local directorySelect a writable directory on the task computer
4Full pageEnable to capture the complete page; disable to capture the visible area
5Image formatSelect png, jpeg, or webp; the default is png

Include task or profile information in the file name to distinguish results:

text
product_${serial_number}_${task_id}

Selecting a local directory and writing a screenshot requires the ZYBrowser desktop client and local file permission.

Screenshot result
Screenshot result

Element Interaction Nodes ​

Hover Element ​

Moves the pointer over a target element to trigger a hover menu, tooltip, or delayed content.

Hover Element configuration
Hover Element configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the target element location; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions

When hover content needs time to appear, add Wait for Element afterward instead of relying only on a fixed delay.

Select Dropdown ​

Locates a dropdown and selects a value. The value must match the option value used by the page.

Select Dropdown configuration
Select Dropdown configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the dropdown location; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions
5Selected valueEnter the underlying option value used by the page

When visible text differs from the underlying value, inspect the page structure or validate with debugging.

Focus Element ​

Focuses a target element before sending a key or shortcut.

Focus Element configuration
Focus Element configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the element to focus; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions

Click Element ​

Locates a target element and performs the selected mouse click.

Click Element configuration
Click Element configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the target element location; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions
5Mouse buttonSelect left, middle, or right; this is hidden for a saved element object
6Click methodSelect single or double click
7Use mouse operationEnable to configure X/Y position and release delay

Left single-click is the usual choice. Mouse mode can be affected by zoom and layout changes, so prefer a standard element click when the element can be located directly.

Enter Text ​

Enters text into a target input.

Enter Text configuration
Enter Text configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the input location; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions
5ContentEnter the text to type; variables are supported
6Clear before typingEnable to remove existing input content first
7Input intervalSet the delay between characters; the default is 300ms

For login and search, clear first to avoid concatenating with a prefilled value. Preserve or increase the interval for pages that are sensitive to input speed.

Sensitive Information

Never write the real value of sensitive variables such as account_password in notes, screenshots, or public logs.

Run JavaScript ​

Runs JavaScript in the page context and optionally saves the return value.

Run JavaScript configuration
Run JavaScript configuration
No.SettingDescription
1JavaScriptWrite the script and define its return value; syntax is checked before saving
2Inject variablesSelect only the system or workflow variables required by the script
3Save return value toEnter a valid output variable name, or leave blank when no downstream node needs it

Example: return the current page title.

js
return document.title;

The script depends directly on the page DOM and runtime environment. Validate it again after a page upgrade and do not use it to bypass a stable standard node operation.

Scroll Page ​

Scrolls the complete page or a selected element.

Scroll configuration
Scroll configuration
No.SettingDescription
1TypeSelect the page or an element; for an element, also configure selector type, location, and order
2PositionSelect top, middle, bottom, or a nonnegative pixel position
3Scroll modeSelect smooth or instant scrolling
4Distance per stepSet the minimum and maximum distance; each step uses a random value in this range
5PauseSet the minimum and maximum pause in milliseconds after each step

For an infinite list, combine stepped scrolling and pauses with Wait for Element or data collection to confirm that new content has loaded.

Upload Attachment ​

Locates a webpage file input and selects attachments from local files, a random file in a folder, or a network URL. The current version supports single-file and multiple-file modes.

Upload Attachment configuration
Upload Attachment configuration
No.SettingDescription
1Element sourceUse an element selector or switch to an upstream saved element object
2Selector typeSelect Selector, XPath, or Text
3SelectorEnter the file input location; variables are supported
4Element orderSelect a fixed value or random range and enter the corresponding positions
5Upload modeSelect single file or multiple files; legacy workflows without this value use single-file mode
6Attachment sourceSelect local file, random file from folder, or network URL
7AttachmentEnter one path or URL in single-file mode, or add an attachment list in multiple-file mode
8Random file countFor multiple random folder files, enter a positive integer
9TimeoutSet the upload timeout; the default is 30000ms

Before running, confirm that local paths exist and are readable on the task computer, folders contain only permitted file types, network URLs point to actual files, and the location rule matches the page file input.

Common Combinations ​

Open a Page and Submit a Form ​

text
Access Website → Wait for Element → Enter Text → Click Element → Wait for Request

Open a New Tab and Return to the Results ​

text
New Tab → Access Website → Actions → Switch Tab

Scroll and Read Lazy-loaded Content ​

text
Scroll Page → Wait for Element → Get Element Data