Methods

absoluteLocation(location_opt) → {Point|Description}

Parameters:

Returns:

If no parameter is provided, the method acts as a getter and returns the absoluteLocation value; otherwise it returns 'this' for use with the builder pattern.

Type

Point | Description

accessibilityName(value_opt) → {string|Description}

The label of the object (where no text label is available).

Parameters:

Name	Type	Attributes	Description
value	string	<optional>	When provided, this method acts as a setter and sets the accessibilityName value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored accessibilityName value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

attributes(attributes_opt) → {Object|Description}

The object's DOM attributes.

Parameters:

Name	Type	Attributes	Description
attributes	Object	<optional>	When provided, this method acts as a setter and sets the attributes value. Specify the attribute names as object keys and set their values to the desired attribute values.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored attrs object; otherwise it returns 'this' for use with the builder pattern.

Type

Object | Description

className(name_opt) → {string|Description}

The object's CSS class (className property).

Parameters:

Name	Type	Attributes	Description
name	string	<optional>	When provided, this method acts as a setter and sets the className value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored className value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

css(selector_opt) → {string|Description}

The path to this object in CSS format. For example: tr.BPTRow input.

Parameters:

Name	Type	Attributes	Description
selector	string	<optional>	When provided, this method acts as a setter and sets the css value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored css value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

firstMenuItem(value_opt) → {string|Description}

The first menu item in the list of items in the menu.

Parameters:

Name	Type	Attributes	Description
value	string	<optional>	When provided, this method acts as a setter and sets the firstMenuItem value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored firstMenuItem value. Otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

id(id_opt) → {string|Description}

The object's HTML identifier.

Parameters:

Name	Type	Attributes	Description
id	string	<optional>	When provided, this method acts as a setter and sets the HTML id value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored HTML id value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

index(value_opt) → {number|Description}

The 0-based index of this object, relative to all other objects with an otherwise identical description.

Parameters:

Name	Type	Attributes	Description
value	number	<optional>	When provided, this method acts as a setter and sets the index to the specified value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored index; otherwise it returns 'this' for use with the builder pattern.

Type

number | Description

innerHTML(innerHTML_opt) → {string|Description}

The HTML code contained between the object's start and end tags.

Parameters:

Name	Type	Attributes	Description
innerHTML	string	<optional>	When provided, this method acts as a setter and sets the innerHTML value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored innerHTML value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

innerText(innerText_opt) → {string|Description}

The text contained between the object's start and end tags.

Parameters:

Name	Type	Attributes	Description
innerText	string	<optional>	When provided, this method acts as a setter and sets the innerText value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored innerText value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

isVisible(visible_opt) → {boolean|Description}

Indicates whether the object is visible.

Parameters:

Name	Type	Attributes	Description
visible	boolean	<optional>	When provided, this method acts as a setter and sets the isVisible value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored isVisible value; otherwise it returns 'this' for use with the builder pattern.

Type

boolean | Description

location(location_opt) → {Point|Description}

The object's coordinates relative to the parent window (in pixels).

Parameters:

Name	Type	Attributes	Description
location	Point	<optional>	When provided, this method acts as a setter and sets the location value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored location value; otherwise it returns 'this' for use with the builder pattern.

Type

Point | Description

name(name_opt) → {string|Description}

The object's name property.

Parameters:

Name	Type	Attributes	Description
name	string	<optional>	When provided, this method acts as a setter and sets the name value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored name value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

outerHTML(outerHTML_opt) → {string|Description}

The object's HTML code and its content.

Parameters:

Name	Type	Attributes	Description
outerHTML	string	<optional>	When provided, this method acts as a setter and sets the outerHTML value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored outerHTML value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

outerText(outerText_opt) → {string|Description}

The object's text (supported in Internet Explorer only).

Parameters:

Name	Type	Attributes	Description
outerText	string	<optional>	When provided, this method acts as a setter and sets the outerText value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored outerText value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

role(roleValue_opt) → {string|Description}

The defined role of this object. For example, if the role property is listbox, the object functions as a list box.

Parameters:

Name	Type	Attributes	Description
roleValue	string	<optional>	When provided, this method acts as a setter and sets the role value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored role value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

size(size_opt) → {Size|Description}

The object's size (in pixels).

Parameters:

Name	Type	Attributes	Description
size	Size	<optional>	When provided, this method acts as a setter and sets the size value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored size value; otherwise it returns 'this' for use with the builder pattern.

Type

Size | Description

styles(styles_opt) → {Object|Description}

The object's computed style.

Parameters:

Name	Type	Attributes	Description
styles	Object	<optional>	When provided, this method acts as a setter and sets the object by its computed style value. * Specify the style names as object keys and set their values to the desired style values.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored styles object; otherwise it returns 'this' for use with the builder pattern.

Type

Object | Description

tagName(tag_opt) → {string|Description}

The object's HTML tag.

Parameters:

Name	Type	Attributes	Description
tag	string	<optional>	When provided, this method acts as a setter and sets the HTML tagName value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored HTML tagName value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

title(title_opt) → {string|Description}

The object's title.

Parameters:

Name	Type	Attributes	Description
title	string	<optional>	When provided, this method acts as a setter and sets the title value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored title value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description

topLevelMenuItems(items_opt) → {Array.<string>|Description}

A collection of all top level menu items in this object.

Parameters:

Name	Type	Attributes	Description
items	Array.<string>	<optional>	When provided, this method acts as a setter and sets the topLevelMenuItems value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored topLevelMenuItems value; otherwise it returns 'this' for use with the builder pattern.

Type

Array.<string> | Description

topLevelMenuItemsCount(itemsCount_opt) → {number|Description}

The number of top level menu items in this object.

Parameters:

Name	Type	Attributes	Description
itemsCount	number	<optional>	When provided, this method acts as a setter and sets the topLevelMenuItemsCount value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored topLevelMenuItemsCount value; otherwise it returns 'this' for use with the builder pattern.

Type

number | Description

vri(value_opt)

Sets a VisualRelation definition.
The VRI definition helps to distinguish this object from other objects with otherwise identical descriptions, based on this object's visual relationship to another object in the application.

Parameters:

Name	Type	Attributes	Description
value	Array.<Object>	<optional>	Array that contains multiple VRI definitions for this test object. Properties Name Type Attributes Default Description anchor Object The related test object. horizontal Horizontal <optional> The horizontal relation definition. hInline boolean <optional> false The horizontal inline definition. vertical Vertical <optional> The vertical relation definition. vInline string <optional> false The vertical inline definition. proximity Proximity <optional> The proximity relation definition.

xpath(selector_opt) → {string|Description}

The path to this object in XPath format. For example: //TR[@id='LeanFT']/*\/INPUT

Parameters:

Name	Type	Attributes	Description
selector	string	<optional>	When provided, this method acts as a setter and sets the xpath value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored xpath value; otherwise it returns 'this' for use with the builder pattern.

Type

string | Description