A Web Window represents a stand-alone browser window or a tab in a multi-page window.
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.
|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 |
|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 |
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 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:
|By Title||Identifies a browser window or tab based on the full Title of the page being displayed.|
|By URL||Identifies a browser window or tab based on the full URL of the page being displayed.|
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.
The following configuration is displayed when Window Creation is selected for the Identification Technique:
|Oldest window||The window that was created before all other windows. Useful for selecting the original browser window for a process.|
|Newest window||The most recently opened window will be used. Useful for selecting popup windows or a newly opened tab.|
|Instance||All available windows are sorted in ascending order based on their time of creation, and the window at the given position will be used.|
The following properties are available when working with a Web Window:
|title||The value of the |
|url||The complete URL of the page being displayed. (Read-only)|
|id||A 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)|
|instance||A number which indicates the order in which the window was detected. The first window has an instance of |
|x||The x-coordinate of the upper-left corner of the window relative to the upper-left corner of the desktop. (Read-only)|
|y||The y-coordinate of the upper-left corner of the element relative to the upper-left corner of the desktop. (Read-only)|
|width||The width, in pixels, of the window. (Read-only)|
|height||The height, in pixels, of the window. (Read-only)|