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

defaultValue(defaultValue_opt) → {string|Description}

The default value in the edit field.

Parameters:

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

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored defaultValue 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

isEnabled(enabled_opt) → {string|Description}

Indicates whether the object is enabled.

Parameters:

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

Returns:

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

Type

string | Description

isReadOnly(readOnly_opt) → {boolean|Description}

Indicates whether this field is read-only.

Parameters:

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

Returns:

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

Type

boolean | Description

isRequired(isRequired_opt) → {boolean|Description}

Indicates whether this field is mandatory.

Parameters:

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

Returns:

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

Type

boolean | 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

maxCharsInLine(value_opt) → {number|Description}

The maximum number of characters allowed per line in this edit field.

Parameters:

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

Returns:

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

Type

number | Description

maxLength(maxLength_opt) → {number|Description}

The maximum number of characters that can be entered in the input field.

Parameters:

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

Returns:

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

Type

number | 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

pattern(pattern_opt) → {string|Description}

The pattern in the edit field.

Parameters:

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

Returns:

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

Type

string | Description

placeholder(placeholder_opt) → {string|Description}

The hint text that is displayed in the edit box until a value is entered in it.

Parameters:

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

Returns:

If no parameter is provided, the method acts as a getter and returns the placeholder 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

rowsCount(rowsCount_opt) → {number|Description}

The number of rows that can be entered in the input field.

Parameters:

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

Returns:

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

Type

number | 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

type(type_opt) → {string|Description}

The type of object as defined in the HTML input tag.

Parameters:

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

Returns:

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

Type

string | Description

value(value_opt) → {string|Description}

The current text in this field.

Parameters:

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

Returns:

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

Type

string | 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