Create XBrowser Modules

XBrowser Modules are created by using Tosca XScan.

Open Tosca Commander, right-click onto a Module folder or use the dynamic menu Modules and select Scan->Application. For further details on how to proceed, please see also chapter "Scan Modules".

Automation with the XBrowser Engine requires Mozilla Firefox, Google Chrome and Microsoft Edge extensions to be installed. When you start scanning a browser window with Tosca XScan, a pop-up dialog informs you if extensions for a specific browser are either missing or outdated.

You can install the extensions for Mozilla Firefox, Google Chrome and Microsoft Edge version 79 or newer either in the browser (see chapter "Install extensions in the browser"), or manually. Extensions for Microsoft Edge version 44 or older must be installed manually (see chapter "Install extensions manually").

Install extensions in the browser

Extensions for Mozilla Firefox, Google Chrome and Microsoft Edge version 79 or newer can be installed in the browser.

Once you start scanning a browser window with Tosca XScan, you will be informed of browser extensions that are either missing or no longer up-to-date.

XScan window indicating that Tosca extensions need to be installed

  1. Click on Yes to install and enable the extension for the specific browser.

  2. For further details on how to install extensions for Mozilla Firefox, Google Chrome and Microsoft Edge version 79 or newer, refer to the corresponding subchapters below ("How to install the Firefox extension", "How to install the Chrome extension", "How to install the extension for Microsoft Edge version 79 or newer"), and continue with step 3 accordingly.

How to install the Firefox extension

  1. Start the installation process by clicking on Add.

  1. The browser must be restarted after installation.

The port of the WebSocket Server can be changed via the Settings button in the Add-ons Manager of the browser. If this is changed, the setting FirefoxExtensionServer must also be changed accordingly in the Tricentis.Automation.RelayService.exe.config file (see chapter "Tricentis.Automation.RelayService.exe.config").

How to install the Chrome extension

  1. Install the Tosca Automation Extension for Chrome with a click on the + Add to Chrome button.

  2. Confirm the installation by clicking on Add in the subsequent dialog window.

Adding a Chrome extension

  1. In the browser window, click on the Customize and control Google Chrome button and select the option More tools->Extensions.

  2. Enable the checkbox next to the option Allow access to file URLs.

The correct settings for the Chrome extension

You can change the port of the WebSocket Server via the menu item Extension options. If you modify this, you must also adapt the setting ChromeExtensionServer accordingly in the Tricentis.Automation.RelayService.exe.config file (see chapter "Tricentis.Automation.RelayService.exe.config").

To confirm that the extension was successfully installed, simply click on the Tosca symbol next to the address bar and the status message Automation possible! will appear.

Status message of the extension icon in Google Chrome

How to install the extension for Microsoft Edge version 79 or newer

  1. Click Allow extensions from other stores.

  2. Click on Add to Chrome to install the Tosca Automation Extension for Microsoft Edge.

  3. Confirm the installation by clicking on Add extension in the subsequent dialog window.

  4. Select Settings and more->Extensions.

  5. Click the Details button for the Tosca Automation Extension for Microsoft Edge.

  6. Enable the checkbox Allow access to file URLs.

To change the port of the WebSocket Server, click Extension options. If you change this port, also change the setting EdgeExtensionServer accordingly in the Tricentis.Automation.RelayService.exe.config file (see chapter "Tricentis.Automation.RelayService.exe.config").

To confirm that the extension was successfully installed, click on the Tosca symbol next to the address bar and the status message Automation possible! will appear.

Install extensions manually

For further details on the manual installation of browser extensions for Tosca XBrowser Engine 3.0, please click on the links below that lead you directly to the Tricentis Knowledge Base: