The information below concerns legacy mobile tests that work with mobile devices connected to the local computer. For new mobile tests, we recommend using the newer cloud-compatible approach.

Description

Returns the iOSProcess object that corresponds to the application that is currently running on the given iOS device.

TestComplete recognizes processes of only those applications that were prepared for testing in a special way.

In addition, in order for TestComplete to be able to access an iOS device connected to your computer, prepare your computer and TestComplete for testing. For more information, see Preparing Applications, Devices, and Test Computers for iOS Testing (Legacy).

Declaration

iOSDeviceObj.Process(ProcessName)

iOSDeviceObj	An expression, variable or parameter that specifies a reference to an iOSDevice object
ProcessName	[in]	Required	String
Result	An `iOSProcess` object

Applies To

The method is applied to the following object:

iOSDevice

Parameters

The method has the following parameter:

ProcessName

The application’s process name, for example, Orders. The process name is case-insensitive.

You can use wildcards (* and ?) to search by a partial name like *Orders.

Result Value

An iOSProcess object that corresponds to the specified process.

Example

The code below obtains the process by its name:

JavaScript, JScript

function GetProcess()
{
var proc = Mobile.Device("iOSDevice").Process("Orders");
}

VBScript

Sub GetProcess
Set proc = Mobile.Device("iOSDevice").Process("Orders")
End Sub

DelphiScript

procedure GetProcess();
var proc;
begin
proc := Mobile.Device('iOSDevice').Process('Orders');
end;