Share this page

# Application

## Mobile. Application

## new Application(propsopt) → {Application}

The description of a mobile application test object.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`props` | Object | <optional> | Initializes the description using the supplied property bag.

##### Returns:

the description object that was initialized.

Type
  Application

# Methods

## identifier(idopt) → {string|Description}

The application identifier string.

##### Parameters:

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

##### Returns:

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

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

## isPackaged(packagedopt) → {boolean|Description}

Indicates whether this application is packaged (instrumented) or not.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`packaged` | boolean | <optional> | When provided, this method acts as a setter and sets the isPackaged value.

##### Returns:

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

Type
  boolean | Description

## name(nameopt) → {string|Description}

The name of the mobile application.

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

## upload(uploadopt) → {number|Description}

The application upload number. The upload number can be used to identify the application uniquely when the application is uploaded more than once.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`upload` | number | <optional> | When provided, this method acts as a setter and sets the application upload number.

##### Returns:

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

Type
  number | Description

## version(versionopt) → {string|Description}

The application version.

##### Parameters:

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

##### Returns:

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

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

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.

Tips to improve your search results... UFT Developer JavaScript SDK Reference Version 15.0-15.0.2 UFT Developer SDK Reference All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: