Skip to main content

Get web page

Sophie avatar
Written by Sophie
Updated over 2 weeks ago

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.

Did this answer your question?