AudioControl

Web. AudioControl

new AudioControl(propsopt) → {AudioControl}

Parameters:
NameTypeAttributesDescription
propsObject <optional>
Initializes an AudioControl test object using the supplied property bag.
Returns:
the description object that was initialized.
Type
AudioControl

Methods

absoluteLocation(locationopt) → {Point|Description}

The object's absolute coordinates relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor.
Parameters:
NameTypeAttributesDescription
locationPoint <optional>
When provided, this method acts as a setter and sets the absoluteLocation value.
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(valueopt) → {string|Description}

The label of the object (where no text label is available).
Parameters:
NameTypeAttributesDescription
valuestring <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(attributesopt) → {Object|Description}

The object's DOM attributes.
Parameters:
NameTypeAttributesDescription
attributesObject <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(nameopt) → {string|Description}

The object's CSS class (className property).
Parameters:
NameTypeAttributesDescription
namestring <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(selectoropt) → {string|Description}

The path to this object in CSS format. For example: tr.BPTRow input.
Parameters:
NameTypeAttributesDescription
selectorstring <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(currentSourceopt) → {string|Description}

The URL of the media file currently selected in the browser window.
Parameters:
NameTypeAttributesDescription
currentSourcestring <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(durationopt) → {number|Description}

The length of the currently selected media file (in milliseconds).
Parameters:
NameTypeAttributesDescription
durationnumber <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(autoPlayopt) → {boolean|Description}

Indicates whether the media file should start playing as soon as it loads.
Parameters:
NameTypeAttributesDescription
autoPlayboolean <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(playbackControlsopt) → {boolean|Description}

Indicates whether the media player should display playback controls.
Parameters:
NameTypeAttributesDescription
playbackControlsboolean <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(idopt) → {string|Description}

The object's HTML identifier.
Parameters:
NameTypeAttributesDescription
idstring <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(valueopt) → {number|Description}

The 0-based index of this object, relative to all other objects with an otherwise identical description.
Parameters:
NameTypeAttributesDescription
valuenumber <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(innerHTMLopt) → {string|Description}

The HTML code contained between the object's start and end tags.
Parameters:
NameTypeAttributesDescription
innerHTMLstring <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(innerTextopt) → {string|Description}

The text contained between the object's start and end tags.
Parameters:
NameTypeAttributesDescription
innerTextstring <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(mutedopt) → {boolean|Description}

Indicates whether the media volume is muted.
Parameters:
NameTypeAttributesDescription
mutedboolean <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(playingopt) → {boolean|Description}

Indicates whether the media file is currently playing.
Parameters:
NameTypeAttributesDescription
playingboolean <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(playInLoopopt) → {boolean|Description}

Indicates whether the media file should start playing again from the beginning as soon as it finishes playing.
Parameters:
NameTypeAttributesDescription
playInLoopboolean <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(visibleopt) → {boolean|Description}

Indicates whether the object is visible.
Parameters:
NameTypeAttributesDescription
visibleboolean <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(locationopt) → {Point|Description}

The object's coordinates relative to the parent window (in pixels).
Parameters:
NameTypeAttributesDescription
locationPoint <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(nameopt) → {string|Description}

The object's name property.
Parameters:
NameTypeAttributesDescription
namestring <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(outerHTMLopt) → {string|Description}

The object's HTML code and its content.
Parameters:
NameTypeAttributesDescription
outerHTMLstring <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(outerTextopt) → {string|Description}

The object's text (supported in Internet Explorer only).
Parameters:
NameTypeAttributesDescription
outerTextstring <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(playbackRateopt) → {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:
NameTypeAttributesDescription
playbackRatenumber <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(currentTimeopt) → {number|Description}

The current playback position in this media file (in milliseconds).
Parameters:
NameTypeAttributesDescription
currentTimenumber <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(roleValueopt) → {string|Description}

The defined role of this object. For example, if the role property is listbox, the object functions as a list box.
Parameters:
NameTypeAttributesDescription
roleValuestring <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(sizeopt) → {Size|Description}

The object's size (in pixels).
Parameters:
NameTypeAttributesDescription
sizeSize <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(sourcesArropt) → {Array.<string>|Description}

The list of all media file source URLs (separated by ;).
Parameters:
NameTypeAttributesDescription
sourcesArrArray.<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(stylesopt) → {Object|Description}

The object's computed style.
Parameters:
NameTypeAttributesDescription
stylesObject <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(tagopt) → {string|Description}

The object's HTML tag.
Parameters:
NameTypeAttributesDescription
tagstring <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(titleopt) → {string|Description}

The object's title.
Parameters:
NameTypeAttributesDescription
titlestring <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(volumeopt) → {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:
NameTypeAttributesDescription
volumenumber <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(valueopt)

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:
NameTypeAttributesDescription
valueArray.<Object> <optional>
Array that contains multiple VRI definitions for this test object.
Properties
NameTypeAttributesDefaultDescription
anchorObjectThe related test object.
horizontalHorizontal <optional>
The horizontal relation definition.
hInlineboolean <optional>
false The horizontal inline definition.
verticalVertical <optional>
The vertical relation definition.
vInlinestring <optional>
false The vertical inline definition.
proximityProximity <optional>
The proximity relation definition.

xpath(selectoropt) → {string|Description}

The path to this object in XPath format. For example: //TR[@id='LeanFT']/*\/INPUT
Parameters:
NameTypeAttributesDescription
selectorstring <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