Browsers.RemoteItem Property

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

Description

Use the Browsers.RemoteItem property to access a web browser controlled by a test automation framework or web driver. It can be:

  • A headless browser running on a local computer and controlled by a web driver.

  • A web browser installed on a remote computer in your local network.

  • A web browser running in a device cloud. It can be a private device cloud managed by Selenium Grid, or a third-party device cloud, for instance, the CrossBrowserTesting device cloud.

Declaration

Browsers.RemoteItem(HubUrl, Capabilities)

Read-Only Property A BrowserInfo object
HubUrl [in]    Required    String    
Capabilities [in]    Required    Object    

Applies To

The property is applied to the following object:

Parameters

The property has the following parameters:

HubUrl

Specifies the URL of the hub that manages the browser you want to access. It can be a private hub running on your local computer or on a remote computer in your local network, or it can be a device cloud provided as a service by a third-party provider, for instance, CrossBrowserTesting or BitBar.

If you have support for local headless browsers enabled, to access them, use:

localhost

To access the BitBar device cloud, use either of these hubs:

EU: https://eu-desktop-hub.bitbar.com/wd/hub

US: https://us-west-desktop-hub.bitbar.com/wd/hub

Capabilities

An object that describes the desired capabilities of the target environment. Which capabilities to use depend on the environment provider.

Property Value

A BrowserInfo object that provides a scripting interface to the desired browser instance.

If your environment provider does not have an environment that matches the specified capabilities, TestComplete will post an error message to the test log.

See Also

Browsers Object
Item Property
About Cross-Platform Web Tests

Highlight search results