Lab

Mobile. Lab

new Lab()

The Digital Lab (UFT Mobile) lab, where you manage users, applications, and devices.

Methods

getConfig() → {Promise.<Mobile.MobileCenterConfiguration>}

Returns the Digital Lab (UFT Mobile) connection configuration.
Returns:
a promise that is fulfilled with the Digital Lab (UFT Mobile) connection configuration.
Type
Promise.<Mobile.MobileCenterConfiguration>

getDeviceList() → {Promise.<Array.<Mobile.DeviceInfo>>}

Returns an array of device information describing all the devices in the Digital Lab (UFT Mobile) lab. The device information can be passed to the lockDeviceByInfo function in order to lock the appropriate device.
Returns:
a promise that is fulfilled with an array of device information describing all the devices in the Digital Lab (UFT Mobile) lab.
Type
Promise.<Array.<Mobile.DeviceInfo>>

getDevicesWithOpenViewers() → {Promise.<Mobile.DeviceTO>}

Returns a list of all devices with an open viewer.
Returns:
a promise that is fulfilled with the list of all devices with an open viewer.
Type
Promise.<Mobile.DeviceTO>

lockDevice(description, appsToInstallopt, deviceSourceopt) → {Promise.<Mobile.DeviceTO>}

Obtains a device from the Digital Lab (UFT Mobile) lab and locks it, so that only UFT Developer can perform actions on it.
Parameters:
NameTypeAttributesDescription
descriptionMobile.DeviceThe description of the device.
appsToInstallArray.<Mobile.Application> <optional>
An Application array of applications to install on the device.
deviceSourceMobile.DeviceSource <optional>
The source location of the device. You can use the DeviceSource object or just pass one of its values as a string.
Returns:
a promise that is fulfilled with the locked device.
Type
Promise.<Mobile.DeviceTO>

lockDeviceById(deviceID) → {Promise.<Mobile.DeviceTO>}

Obtains a device from the Digital Lab (UFT Mobile) lab by deviceID and locks it, so that only UFT Developer can perform actions on it.
Parameters:
NameTypeDescription
deviceIDstringThe device ID used by Digital Lab (UFT Mobile).
Returns:
a promise that is fulfilled with the locked device.
Type
Promise.<Mobile.DeviceTO>

lockDeviceByInfo(deviceInfo) → {Promise.<Mobile.DeviceTO>}

Obtains a device from the Digital Lab (UFT Mobile) lab by device information and locks it, so that only UFT Developer can perform actions on it.
Note: The device information is the structure returned by the getDeviceList function.
Parameters:
NameTypeDescription
deviceInfoMobile.DeviceInfoThe device information of the device to lock.
Returns:
a promise that is fulfilled with the locked device.
Type
Promise.<Mobile.DeviceTO>

lockDeviceByName(deviceName) → {Promise.<Mobile.DeviceTO>}

Obtains a device from the Digital Lab (UFT Mobile) lab by device name and locks it, so that only UFT Developer can perform actions on it.
Parameters:
NameTypeDescription
deviceNamestringThe logical name that Digital Lab (UFT Mobile) uses to identify the device.
Returns:
a promise that is fulfilled with the locked device.
Type
Promise.<Mobile.DeviceTO>

lockDeviceWithOptions(description, sessionOptions) → {Promise.<Mobile.DeviceTO>}

Obtains a device from the Digital Lab (UFT Mobile) lab and locks it, so that only the current UFT Developer test can perform actions on it.
Parameters:
NameTypeDescription
descriptionMobile.DeviceThe description of the device.
sessionOptionsObjectthe session options to use.
Properties
NameTypeAttributesDefaultDescription
appsToInstallArray.<Mobile.Application> <optional>
An Application array of applications to install on the device.
deviceSourceMobile.DeviceSource <optional>

The source location of the device.
You can use the DeviceSource object or just pass the relevant string value.
UFT Developer 2023 or earlier: 'mobile_center', 'amazon_device_farm' or 'any'.
UFT Developer 23.4: 'on_premises', 'aws' or 'any'. To support the previously used values, contact support for a hotfix.


collectLogsbool <optional>
true indicates whether logs should be collected in this session.
collectVitalsObject <optional>
Defines which device vitals should be collected in this session.
Properties
NameTypeAttributesDefaultDescription
cpubool <optional>
false indicates whether to collect the device CPU usage.
memorybool <optional>
false indicates whether to collect the device memory usage.
freeMemorybool <optional>
false indicates whether to collect the device free memory.
Returns:
a promise that is fulfilled with the locked device.
Type
Promise.<Mobile.DeviceTO>