Much like every site on the internet, we use cookies to help analyze traffic and improve our website. As outlined in our privacy policy, any information is only used internally and is not shared with outside organizations.
Learn More

Web Window

Overview

A Web Window represents a stand-alone browser window or a tab in a multi-page window.

Topics:

Working with Web Windows

The following describe some of the common scenarios for working with a Web Window. For any Activity that expects you to identify an element, refer to the Identification Techniques topic for how to indicate the target element of the Activity will be the Web Window.

ScenarioInstructions
Open a URL Use the Navigate to URL Activity to navigate to a given URL. If a browser window is not already open, one will be opened to display the page. Otherwise, the current browser window will navigate to the URL specified. This activity will always work with the current browser window, so element identification is not necessary.
Refresh a page Use the Refresh web page Activity to refresh the contents of the page loaded in the current browser window. This activity will always work with the current browser window, so element identification is not necessary.
Navigate backwards or forward Use the Navigate backwards and Navigate forward Activities to navigate backwards or forward in the browser history of the current browser. These activities are the equivalent of the Back and Forward buttons on a Web Browser application. These activities will always work with the current browser window, so element identification is not necessary.
Maximize or Minimize the window Use the Maximize browser and Minimize browser Activities to maximize or minimize the browser window. These activities will always work with the current browser window, so element identification is not necessary.
Move or resize the window The Adjust browser window Activity can be used to change the location and/or the size of the window. This activity will always work with the current browser window, so element identification is not necessary.
Switch to another window or tab If your need to interact with a new window or browse tab, the Switch browser window Activity will change the current browser to the window or tab you identify. You will then be able to interact with the new window or tab.
Close a window or tab The Close browser window Activity will close the current window or tab. If the window or tab you want to close is not the one which is currently active, use the Switch browser window activity to first activate the desired window or tab, and then call the Close browser window activity.
When the active window or tab is closed, the previously active window or tab will then become active. If no other windows or tabs are available, the entire browser will be closed.
Wait for a window to appear To pause execution while you want for a window to appear, use the the Wait until element exists Activity with an Element Identification Technique that identifies a window element.
Verify the title or URL (using expressions) To verify the title or URL, use the Verify expression value Activity. Set the Expression argument of the Activity Call to either the {CurrentBrowserTitle} or {CurrentBrowserUrl} Session Variable. Use the remaining arguments to define the conditions for the verification.
Verify the title or URL (using properties) To verify the title or URL, use the Verify property value Activity with an Element Identification Technique that identifies a window element. Set the Name argument of the Activity Call to either the title or url property name. Use the remaining arguments to define the conditions for the verification. See below for a list of all supported properties.

Identification Techniques

The following are the techniques supported by a Web Window element that can be used by an Activity Call that needs to identify a Web Window. Refer to the Element Identification topic for more details on how to define the identification technique for an element.

Simple Identification

Simple Identification is a standard Element Identification Technique available to multiple Element Types and is intended to provide quick, single-value identification of elements. The following options are available when using Simple Identification for a Web Window:

MethodDescription
By TitleIdentifies a browser window or tab based on the full Title of the page being displayed.
By URLIdentifies a browser window or tab based on the full URL of the page being displayed.

Property Conditions

Property Conditions is a standard Element Identification Technique available to multiple Element Types where the properties of an element are used to identify it. Use the list of properties below when using this technique with a Web Window.

Window Creation

The following configuration is displayed when Window Creation is selected for the Identification Technique:

Screenshot Element Window Creation Identification Technique

Note: The example screenshot above is from a pre-release version of AutoBloks and may differ slightly from the current product.

MethodDescription
Oldest windowThe window that was created before all other windows. Useful for selecting the original browser window for a process.
Newest windowThe most recently opened window will be used. Useful for selecting popup windows or a newly opened tab.
InstanceAll available windows are sorted in ascending order based on their time of creation, and the window at the given position will be used.

Properties

The following properties are available when working with a Web Window:

Property NameDescription
titleThe value of the title HTML tag which will be displayed in the browser window title bar or browser tab. (Read-only)
urlThe complete URL of the page being displayed. (Read-only)
idA unique identifier for the window. This value will change every time your Process runs, so it should not be used for permanent identification. (Read-only)
instanceA number which indicates the order in which the window was detected. The first window has an instance of 1. (Read-only)
xThe x-coordinate of the upper-left corner of the window relative to the upper-left corner of the desktop. (Read-only)
yThe y-coordinate of the upper-left corner of the element relative to the upper-left corner of the desktop. (Read-only)
widthThe width, in pixels, of the window. (Read-only)
heightThe height, in pixels, of the window. (Read-only)