Virtual Web Application Parameters

Applies to TestComplete 15.47, last modified on January 20, 2023

The Tested Applications collection can include the mobile browser emulator. The emulator is used to test mobile web sites on desktop computers where TestComplete is installed. You can add the emulator to the TestedApps editor to be able to quickly launch it at design time.

The mobile browser emulator’s parameters are organized into two sections in the TestedApps editor - Basic Parameters and Run-Mode Parameters.

Tested application items that correspond to the mobile browser emulator should be used only to launch the emulator at design time. Do not run the emulator as a tested application in tests. To launch the emulator from tests, use the Run Virtual Browser keyword test operation or the VirtualBrowsers.Item(browser_name).Run scripting method.

Basic Parameters

Basic parameters include the following:

Parameter Description
Name The unique name of the tested application in the Tested Applications collection. This name is used to refer to the application in tests, for example, in the Run TestedApp keyword test operation.
Count The number of application instances that will be simultaneously launched during the test recording or run.
Autorun application on recording Select this option to have the application launched automatically when you start test recording.
Launch application from tests Uncheck this option to prevent the application from being launched by the Run TestedApp keyword test operation and the TestedApps.AppName.Run scripting method.

For example, you can define several instances of the tested application with different configurations and “disable” those not needed at the moment.

Use special runtime object This option controls the scripting interface to the tested application.

If it is enabled, you can get and set the application parameters directly via the TestedApp.AppName object. This object is a VirtualWebTestedApp object.

If it is disabled (not recommended except for legacy tests), TestedApp.AppName returns a generic TestedApp object that contains properties and methods common to all application types. To set emulator-specific parameters, use the TestedApps.AppName.Params.VirtualWebParams property.

Run-Mode Parameters

The following parameters are specific to the mobile browser emulator added to the Tested Applications collection:

Parameter Description
Page URL The URL to open in the mobile browser emulator. Specify the protocol (for example, http:// or https://) at the beginning of the URL.
Virtual Browser The mobile browser to emulate. The combo box contains all the browser profiles specified in the Open Applications | Web Testing | Virtual Browsers properties of the current test project. To learn how to add custom mobile browser profiles to a test project, see Creating Mobile Browser Profiles.
Command-line arguments Command-line parameters used to customize the behavior of the mobile browser emulator. For more information, see Specifying Additional Parameters for Mobile Browser Emulator.

See Also

About Tested Applications
Testing Mobile Web Applications Using Emulator - Overview
TestedApps Editor
Run Modes and Parameters

Highlight search results