Browser description properties
Object description properties can be used in the object repository description, in programmatic descriptions, in checkpoint and output value steps, and as argument values for the GetTOProperty and GetROProperty methods.
The Browser test object supports the description properties listed in the table below.
Property Name | Description |
---|---|
abs_x | The object's absolute x-coordinate (left) relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor. If you are working with multiple monitors, the coordinate in the secondary monitor is relative to the primary monitor. For example, given a resolution of 1280 x 1024 in the primary monitor, if the secondary monitor is positioned to the right of the primary monitor, the x-coordinate is 1280 or greater. If the secondary monitor is placed to the left of the primary monitor, the x-coordinate is negative. |
abs_y | The object's absolute y-coordinate (top) relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor. If you are working with multiple monitors, the coordinate in the secondary monitor is relative to the primary monitor. For example, given a resolution of 1280x1024 in the primary monitor, if the secondary monitor is positioned below the primary monitor, the y-coordinate is 1024 or greater. If the secondary monitor is placed above the primary monitor, the y-coordinate is negative. |
application version | The browser's version. |
creationtime | The ordinal identifier that OpenText Functional Testing assigns to the browser to indicate the order in which the browser was opened relative to other open browsers with an otherwise identical description. This property cannot be used with GetROProperty. |
browser_identifier | Identifies the browser application. Optionally, add this property to the object’s description properties to run the test on the specified browser instead of the one defined on the Mobile tab of the Record and Run Settings dialog box. Possible values:
Caution: Add this property to the object’s description properties only if you have Mobile Browser selected in the Use field of the Web tab. If you have Local Browser or Cloud Browser selected and you run a test with objects defined with this description property, unexpected results may occur. |
device_manufacturer | The manufacturer of the device on which the browser is running. |
device_model | The model of the device on which the browser is running. |
device_ostype | The OS type of the device on which the browser is running. |
device_osversion | The OS version of the device on which the browser is running. |
HasMenuBar | Indicates whether the menu bar for the object is visible. This property is only available for Internet Explorer. Possible values: |
HasStatusBar | Indicates whether the status bar for the object is visible. This property is only available for Internet Explorer. Possible values: |
HasToolbar | Indicates whether the toolbar for the object is visible. This property is only available for Internet Explorer. Possible values: |
height | The object's height (in pixels). |
host | Identifies the application’s host. When the host is a mobile device, the value requires a prefix of mobiledevice: followed by the device's Unique Device Identifier (the Device UDID). For example: mobiledevice:a1904d91 Note: The prefix mobilecenter: is also supported, for backward compatibility only. Optionally, add this property to the object’s description properties to run the test on the specified device instead of the one defined on the Mobile tab of the Record and Run Settings dialog box. Caution: Add this property to the object’s description properties only if you have Mobile Browser selected in the Use field of the Web tab. If you have Local Browser or Cloud Browser selected and you run a test with objects defined with this description property, unexpected results may occur. |
HWND | The browser's Windows 32 handle. Note: This property is supported only for Internet Explorer and for Firefox versions earlier than 57. |
index | The ordinal identifier that OpenText Functional Testing assigns to the object to indicate the order in which the object appears in the code relative to other objects with an otherwise identical description. This property cannot be used with GetROProperty. |
location | The ordinal identifier that OpenText Functional Testing assigns to the object to indicate where the object appears within the window, frame, or dialog box. Values are assigned from top to bottom, and left to right. This property cannot be used with GetROProperty. |
name | The object's name. |
number of tabs | The number of currently open tabs in the browser. |
OpenTitle | The object's initial title when first opened. |
OpenURL | The URL from which the object is first opened. |
OpenedByTestingTool | Indicates whether the object was opened by OpenText Functional Testing. This property is only available for Internet Explorer. Possible values: |
title | The browser's title. |
Top_level_hwnd | The browser's Windows 32 handle. Note: This property is supported for Internet Explorer and Firefox browsers only. |
version | The version of the browser control. For a list of supported browser versions, see the OpenText Functional Testing Support Matrix. |
visual relations | Represents the test object's visual relations identifier. Use this property in GetTOProperty and SetTOProperty steps to return or apply a VisualRelationsCollection object for a test object. The VisualRelationsCollection object enables you to retrieve or replace the visual relation identifier settings of a test object during a run session. Syntax: SetVRIColl = TestObject.GetTOProperty("visual relations") TestObject.SetTOProperty "visual relations", VRIColl For details, see VisualRelationsCollection Object in the Utility section of the OpenText Functional Testing Object Model Reference for GUI Testing. This property is not listed in the Object Spy. It is not retrieved when you use the GetTOProperties method. It cannot be used in the Object Identification dialog box, the description area of the object repository, checkpoint or output value steps, and so on. |
width | The object's width (in pixels). |
WindowContext | The browser content type, determined by the context in which the browser was opened. Note: This property is relevant only when working in the Siebel Test Automation environment with the Siebel Add-in loaded. Possible values:
|
See also: