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:
-
Open the test case building area by selecting
Create test case in the menu bar on the left. -
Select Modules and then + Create module.
-
Depending on your use case, select Browser, Application, or Debug Port.
-
Select the window you want to scan and then select Scan.
I want to scan a remote browser
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.
I want to scan an embedded browser application
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.
I want to connect to an already open browser
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.