Web
Browser - Wait
Declaration
<AMWEBBROWSER ACTIVITY="state" SESSION="text" WAITTIME="number" />
Description
Waits an additional amount of time after the web browser window has finished loading (and is ready for input) before continuing to the next step.
- The Web Browser action is not backwards compatible with the Web Browser (Legacy) action.
- Automation with the Web Browser action is only compatible with Internet Explorer, Chrome, Edge, and Firefox browsers.
- You must update the specified browser to the latest version and install it on the target system to ensure the Web Browser action functions correctly.
- Unlike other session-based actions where sessions are optional, the Web Browser action requires the use of a session as each created session explicitly links to a specific web browser instance (you can create a session using the Web Browser - Create session or Web Browser - Open activity). A single task can support numerous sessions; however, since Web Browser activities are performed interactively (and not in the background), each session must run concurrently to avoid sending interactions to the wrong browser window.
Practical usage
Used as a supplementary wait parameter to allow a web browser to wait a specific period of time after it is ready for input. Alternatively, the Wait action contains other ways to pause execution or wait for a specific event to occur.
Parameters
Location
| Property | Type | Required | Default | Markup | Description |
|---|---|---|---|---|---|
| Session name | Text | Yes | BrowserSession1 | SESSION="mySession" | Specifies
the name of an existing session to associate with this activity.
Numerous sessions can exist within a single task which allows activities
to be performed on several web browsers simultaneously. NOTE: Sessions are supported in Internet Explorer, Chrome, Edge, and Firefox browsers
only. Firefox does not require a separate extension to be installed with this version of the Web Browser action |
State
| Property | Type | Required | Default | Markup | Description |
|---|---|---|---|---|---|
| Wait until the browser is ready for input, then wait an additional | Number | No | (Disabled) | WAITTIME="3" | If
enabled, specifies the amount of seconds this activity
waits after the browser is ready for input before continuing to
the next step.
NOTE: This activity always waits until the browser is ready for
input. It can wait an additional amount of time as specified,
but it is not required. |
Example
- Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
- To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.
Description
This sample task opens a Firefox web browser to http://www.google.com/ and waits 5 seconds before navigating to https://www.fortra.com/product-lines/automate.
<AMWEBBROWSER URL="www.google.com" BROWSER="firefox" SESSION="BrowserSession1" />
<AMWEBBROWSER ACTIVITY="state" SESSION="BrowserSession1" WAITTIME="5" />
<AMWEBBROWSER ACTIVITY="navigate" SESSION="BrowserSession1" URL="https://www.fortra.com/product-lines/automate" />