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

currentSource(currentSource_opt) → {string|Description}

The URL of the media file currently selected in the browser window.

Parameters:

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

Returns:

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

Type

string | Description

duration(duration_opt) → {number|Description}

The length of the currently selected media file (in milliseconds).

Parameters:

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

Returns:

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

Type

number | Description

hasAutoPlay(autoPlay_opt) → {boolean|Description}

Indicates whether the media file should start playing as soon as it loads.

Parameters:

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

Returns:

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

Type

boolean | Description

hasPlaybackControls(playbackControls_opt) → {boolean|Description}

Indicates whether the media player should display playback controls.

Parameters:

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

Returns:

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

Type

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

isMuted(muted_opt) → {boolean|Description}

Indicates whether the media volume is muted.

Parameters:

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

Returns:

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

Type

boolean | Description

isPlaying(playing_opt) → {boolean|Description}

Indicates whether the media file is currently playing.

Parameters:

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

Returns:

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

Type

boolean | Description

isPlayInLoop(playInLoop_opt) → {boolean|Description}

Indicates whether the media file should start playing again from the beginning as soon as it finishes playing.

Parameters:

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

Returns:

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

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

playbackRate(playbackRate_opt) → {number|Description}

Indicates the speed of the media playback.
Remark: Possible values: numbers with up to two decimal places. For example, 0.51 or 1.00.

Parameters:

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

Returns:

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

Type

number | Description

playbackTime(currentTime_opt) → {number|Description}

The current playback position in this media file (in milliseconds).

Parameters:

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

Returns:

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

Type

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

sources(sourcesArr_opt) → {Array.<string>|Description}

The list of all media file source URLs (separated by ;).

Parameters:

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

Returns:

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

Type

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

volume(volume_opt) → {number|Description}

Indicates the volume used when playing the media file.
Remark: Possible values: numbers with up to two decimal places. For example, 0.51 or 1.00.

Parameters:

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

Returns:

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