Scan with WebDriver
Your application has various controls, which are elements that Tosca Cloud interacts with when you run your tests. To make this possible, you must first scan your application. This gets the necessary technical data into Tosca Cloud.
This topic explains how to scan
-
You want to scan a remote browser on a Selenium grid.
-
You want to scan an embedded browser application.
-
You want to connect to a browser that's already open.
Start the scan
To start the scan, follow these steps:
-
Select
Build on the left menu bar. -
Select
All assets or 
Modules from the menu. You can also find All and Modules as tabs in the Inventory page. These options are equivalent when it comes to scanning. -
Select Create >
Module (Scan).
-
Depending on your use case, select Browser, Application, or Debug Port.
-
Select the window you want to scan and then select Scan.
To scan a browser, follow these steps:
-
Define the following parameters:
Parameter
Description
Hub address
Select or enter where you want to scan:
-
localhost to scan locally
-
BrowserStack to scan via BrowserStack
-
Enter the IP address of the grid hub
Browser
Select the browser type you want to start (Chrome, Edge, Firefox or Safari).
Browser version
Select the browser version number you want to start.
OS
Select the operating system where browser will start.
Debug Port
Enter the debug port of an already running embedded Chromium application.
WebDriver Path
Enter the path to the WebDriver file. If you don't enter a path, Tosca Cloud uses the default location.
URL
Enter URL of the website you want to scan.
-
-
Select Open Browser to open a browser for scanning. The hub chooses a node that can open the browser you selected and opens a new instance using the URL you entered.
After the browser window opens, it appears as a scannable window in the Select Application window.
Bear in mind these points:
-
There is a maximum limit to how many browser instances you can have open for each node on the grid hub.
-
Tosca XScan does not provide full functionality when you scan remotely.
To scan an application, follow these steps:
-
Define the following parameters:
Parameter
Description
Browser
Select Chrome or Edge.
Application Path
Enter the path to the embedded Chromium application you want to start and scan.
Alternatively, select ... and then select the executable file.
WebDriver Path
Enter the path to the WebDriver file.
Alternatively, select ... and then select the WebDriver file.
URL
Enter the URL of the website you want to scan.
-
Select Open Application to open the application and start scanning.
Debug port lets you connect to and scan an already open browser. To scan a debug port, follow these steps:
-
Define the following parameters:
Parameter
Description
Browser
Select Chrome or Edge.
Debug Port
Enter the debug port of an already running embedded Chromium application.
WebDriver Path
Enter the path to the WebDriver file.
Alternatively, select ... and then select the WebDriver file.
-
Select Connect to Port to open the application and scan it.
Use BrowserStack
To use BrowserStack to scan modules, follow these steps:
-
In Tosca XScan, select Settings.
-
Under XBrowser: WebDriver: BrowserStack, enter the following information:
-
Access Key
-
Hub Address
-
Username
-
-
Close the Settings window and select Browser.
-
Define the following parameters:
Parameter
Description
Hub address
Select BrowserStack.
Browser
Select the browser type you want to start (Chrome, Edge, Firefox, or Safari).
Browser version
Select the browser version number you want to start.
OS
Select the operating system where browser will start.
Debug Port
Enter the debug port of an already running embedded Chromium application.
WebDriver Path
Enter the path to the WebDriver file. If you don't enter a path, Tosca Cloud uses the default location.
URL
Enter URL of the website you want to scan.
-
Select Open Browser to open a browser for scanning.
What's next
Now that you have WebDriver modules, you can start creating tests for remote browsers or embedded applications.