XBrowser Engine 3.0

Tosca XBrowser Engine 3.0 can be used to test web applications.

To ensure that web applications are properly scanned and tested with XBrowser Engine 3.0, perform the following actions:

  • Set the zoom factor of your browser to 100%.

  • Set the zoom factor of the Windows display settings to one of the standard values such as 100% or 125%.

Installation

The XBrowser Engine 3.0 is part of the Tricentis Tosca standard installation.

For detailed information on software versions and hardware requirements, see the system requirements.

Specify the browser

During test execution, the system searches automatically all open browsers for the control to be steered.

You can also use test configuration parameters to specify the browser that you want to steer.

Create a test configuration parameter

The Name of the test configuration parameter must be Browser. In the Value column, enter one of the following values:

  • InternetExplorer

  • Firefox

  • Chrome

  • Edge

Test configuration parameter for running tests in Internet Explorer

You can use all supported browsers to scan online websites. Tricentis recommends that you use either Chrome, Firefox or Internet Explorer to scan local websites.

Quirks mode

If the HTML document does not begin with the DOCTYPE definition (<!DOCTYPE html ...>), the document is executed in Quirks mode. This allows the DOM tree to be generated differently in the various browsers.

Ensure to disable the Quirks mode to be able to scan and test such screens accordingly. Press F12 to select one of the provided standard modes.

Disabling the quirks mode

Activate Terminal Server support

To test your web applications on browsers that are running on a Terminal Server, you must first activate the Terminal Server support for the XBrowser Engine 3.0. Note that if you use the Tosca Automation Extension for Microsoft Edge Chromium or Google Chrome and have installed it manually, you must perform preparatory steps before you activate Terminal Server support:

To activate Terminal Server support for the XBrowser Engine 3.0 on your Terminal Server, follow the steps below:

  1. Stop the service TOSCAAutomationService in the Windows Task Manager.

  2. Open the file Tricentis.Automation.RelayService.exe.config in any text editor. The file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox.

  3. Change the value of the setting EnableTerminalServerSupport to True.

  4. Save and close the file.

  5. Restart the service TOSCAAutomationService in the Windows Task Manager.

The example below shows the activation of the Terminal Server support:

<applicationSettings>
    <Tricentis.Automation.RelayServiceSettings>
        ...
        <setting name="EnableTerminalServerSupport" serializeAs="String">
            <value>True</value>
        </setting>
    </Tricentis.Automation.RelayServiceSettings>
</applicationSettings>

Preparatory steps for Microsoft Edge Chromium

You must perform preparatory steps if you use the Tosca Automation Extension for Microsoft Edge Chromium and have installed it manually from C:\Program Files (x86)\Tricentis\Tosca Testsuite\TBox\Resources\EdgeChromiumExtension. Complete the following before you activate Terminal Server support for the XBrowser Engine 3.0:

  1. Once you have installed the Tosca Automation Extension, click the ... icon in the upper right corner of the browser.

  2. Select Extensions to open the Extensions page.

  3. Enable the Developer mode.

  4. In the Installed extensions section of the Extensions page, copy the ID of the Tosca Automation Extension for Microsoft Edge.

Tosca Automation Extension for Microsoft Edge: copy ID

  1. Open the file Tricentis.Automation.HtmlEngineExtensionHelper.manifest.json in any text editor. The file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox.

  2. Paste the value of the ID to allowed_origins.

  3. Save and close the file.

Now that you have completed the preparatory steps, you can activate the Terminal Server support for the XBrowser Engine 3.0.

Preparatory steps for Google Chrome

You must perform preparatory steps if you use the Tosca Automation Extension for Google Chrome and have installed it manually from C:\Program Files (x86)\Tricentis\Tosca Testsuite\TBox\Resources\ChromeExtension. Complete the following steps before you activate Terminal Server support for the XBrowser Engine 3.0:

  1. Once you have installed the Tosca Automation Extension, click the Customize and control Google Chrome icon in the upper right corner of the browser.

  2. Select More tools and click on Extensions.

  3. Enable the Developer mode in the upper right corner.

  4. Copy the ID of the Tosca Automation Extension for Chrome.

Tosca Automation Extension for Chrome: copy ID

  1. Open the file Tricentis.Automation.HtmlEngineExtensionHelper.manifest.json in any text editor. The file is located at C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox.

  2. Paste the value of the ID to allowed_origins. For example: chrome-extension://imcdjpcmdahnfbhbnlocnifhjmoifpdf/.

  3. Save and close the file.

Now that you have completed the preparatory steps, you can activate the Terminal Server support for the XBrowser Engine 3.0.