VirtualBrowsers.Item Property

Applies to TestComplete 15.63, last modified on April 10, 2024


The VirtualBrowsers.Item property returns a mobile browser profile by its name or index. The returned VirtualBrowserInfo object contains information about the browser profile (user agent, screen size and so on) and lets you launch the mobile browser emulator with this profile.



Read-Only Property A VirtualBrowserInfo object.
NameOrIndex [in]    Required    Variant    

Applies To

The property is applied to the following object:


The property has the following parameter:


One of the following:

  • A string with the name of the browser profile. For example, "Apple iPad". For possible values, check the project’s Virtual Browsers properties.

  • The position (starting from 0) of the browser profile in the project’s Virtual Browsers properties. Note that only the enabled profiles are taken into account.

Property Value

The VirtualBrowserInfo object that corresponds to the mobile browser profile with the specified name or index.

If the specified browser profile is disabled (it is unchecked in the project’s Virtual Browsers properties), an error is posted to the test log. An error is also logged if there is no browser profile with the specified name or index.


The VirtualBrowsers object provides access only to the enabled browser profiles (those that are checked in the project’s Virtual Browsers properties). The disabled profiles cannot be accessed via the VirtualBrowsers object.


This following code launches the iPad browser emulator with an URL:

JavaScript, JScript

VirtualBrowsers.Item("Apple iPad").Run("");


VirtualBrowsers.Item["Apple iPad"].Run("");


Call VirtualBrowsers.Item("Apple iPad").Run("")


VirtualBrowsers.Item['Apple iPad'].Run('');

C++Script, C#Script

VirtualBrowsers["Item"]("Apple iPad")["Run"]("");

See Also

Testing Mobile Web Applications Using Emulator
VirtualBrowsers Object
VirtualBrowserInfo Object

Highlight search results