The Run Virtual Browser operation launches the mobile browser emulator with the specified URL (if any). You can choose one of the predefined mobile browser profiles – Apple iPhone 7, Samsung Galaxy S3 and others – or use a custom browser profile defined in your test project. For more information, see Testing Mobile Web Applications Using Emulator.
To repeat the test operations in multiple mobile browsers in a loop, use the Virtual Browser Loop operation.
A license for TestComplete Web module
The Web Testing and Chrome Support plugins (they are part of the Web module).
Google Chrome 93.
If you have a TestComplete version earlier than 12.42, your version of the SmartBear Test Extension will be incompatible with newer versions of the Chrome web browser. To test web applications in Chrome 93, you will have to upgrade your TestComplete to some later version. We recommend using version 14.93.
If you use a later version of Google Chrome, check whether a patch is available for it.
For details, see Requirements for Mobile Web Testing Using Emulator.
|Chrome must not be running before the operation is run. See Remarks below.|
The operation does not return any value.
The operation does the same as the
The operation cannot have child operations.
When you add the operation to a keyword test, TestComplete displays a wizard with the following pages.
Select Virtual Browser
Here you can select the mobile browser to emulate. The page lists all mobile browser profiles that are defined in the project’s Virtual Browsers table, except for those that are unchecked in the table.
If you want to specify a mobile browser name using a variable or a parameter, select Parameterize.
Browser Selection Parameters
If you selected Parameterize on the Select Virtual Browser page, you will see this page. It contains one parameter:
Required. A string with the name of a mobile browser profile, or its integer index (zero-based) in the project’s Virtual Browsers table. You can select a mobile browser profile from the drop-down list or specify a constant, test parameter, project variable or code expression that returns the profile name or index.
For more information about specifying parameter values, see Specifying Operation Parameters.
Here you can specify the following parameters:
The URL to be opened in the mobile browser emulator. Specify the protocol (for example, http:// or https://) at the beginning of the URL.
If left empty, TestComplete starts the mobile browser emulator with a blank page (about:blank).
The time, in milliseconds, to wait until the page is loaded and ready to accept user input. The operation execution finishes once the page is loaded completely or this timeout is reached.
If omitted or -1, the timeout is specified by the project’s Web page loading timeout property.
Google Chrome must not be running before the operation is run. If Chrome is already running, the operation opens a new tab in the running Chrome instance rather than starts the Chrome mobile emulator.
After the mobile browser emulator is launched, the
Aliases.browserobject points to the browser emulator and provides access to the web pages that are open in it.
The operation logs an event message if it succeeded and an error message if it failed.