Definition and Usage
Get web page allows you to retrieve an open web page by matching its title or URL. This command enables you to interact with existing browser sessions or open new pages when needed.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Browser | Select a browser type to operate on | Built-in browser, Google Chrome, Microsoft Edge, 360 Secure Browser, AdsPower, BitBrowser, SuperBrowser | Yes | Choose the browser where you want to get the web page |
Browser ID | Specify browser ID obtained from browser information | - | Yes* | *Required if "Browser" is set to AdsPower/BitBrowser |
Match by | Choose how to match the open web page | Page title, Page URL, Current page | Yes | Determines the method used to identify the target web page |
Match text | Enter text to match (supports fuzzy matching) | - | Yes* | *Required when “Match by” is set to Page title/Page URL |
Use RegEx | Use RegEx for text matching | - | No | Enable to use regular expressions for more flexible matching |
Advanced settings
Parameter | Description | Possible Values | Required | Options / Notes |
Wait for page to fully load | Choose whether to wait for the web page to fully load | - | No | Enable to ensure the page is completely loaded before proceeding |
Timeout (s) | Specify the amount of time (in seconds) to wait for the page to load | - | No | Default is 20 seconds |
On timeout | Choose the action to perform after page load timeout | Perform On error actions, Stop loading | Yes | Determines what happens when the page load timeout is reached |
Open new page if match fails | Open new page if matching by title or URL fails | - | No | When enabled, a new page will be opened if no matching page is found |
URL | URL for the new web page | - | No* | *Required when "Open new page if match fails" is checked |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
This action produces the following variable:
webPage
: Stores the web page into a new variable that can be used in subsequent actions.
Using Variables in Conditions
Parameters marked with {x} indicate that you can insert variables previously defined in your workflow. This allows for dynamic values to be used when matching web pages or specifying URLs. When using variables, ensure that the variable type matches what the parameter expects (e.g., text strings for URLs or page titles).
Notes
When using "Match by: Current page", no match text is required as it will use the currently active browser tab.
The "Built-in browser" option uses an embedded browser that runs within the RPA environment.
Regular expression matching (RegEx) provides more powerful pattern matching capabilities but requires proper regex syntax.
If "Open new page if match fails" is enabled, ensure you provide a valid URL to navigate to.
Browser ID is only needed when you want to interact with a specific browser instance that was previously captured.