Configuring Chrome for Test Studio Automation
This document describes the steps to enable Chrome browser for test recording and execution.
1. Enable Chrome for Automation
In Test Studio release 2022 R1 (v.2022.1.xx) you can choose how to record and execute tests with Chrome browser. In this version it can be enabled for automation with or without the Progress Test Studio Extension. The setting how Chrome will be used is set on project level, which means that you can use both options at the same time depending on the project you work from.
Enable Chrome for Automation with Extension
By default each Test Studio project is set to use Chrome with the extension. So, if this is the option you want to use, you need to install the latest Progress Telerik Test Studio Extension from the Chrome Web Store.
Enable Chrome for Automation without Extension
If you choose to use Chrome for recording and execution without additional extension, you need to change a setting in the Test Studio project. The project setting is listed under the Browsers tab and is named Use browser extension (it is enabled by default). Uncheck the checkbox and Test Studio will start the Chrome browser for this project without using the extensions even if this is installed.
2. Browser Calibration
To ensure a flawless and consistent automation process, there are a few browser settings that we need to apply. We call this browser calibration and have implemented a feature to automatically calibrate the browser out of the box. No manual interaction is required.
Important
If your Chrome browser has an active Google Apps session (for example, you are logged into GMail), automatic calibration will not work as expected. To use automatic configuration, log out of your Google account first.
Tip
You can check all settings applied from the calibration in the Manual Configuration section below (click the + sign to expand it).
1. When you start recording against Chrome, but the Progress extension is not installed, the browser will load the recording start page and will try to load the extension. The recorder will search for the extension for the period that is defined in the *ClientReady* Timeout (the default is 60 seconds).
2. If the Progress extension doesn't load within the timeout period, a link to the Web Store will be displayed to install the extension.
3. By clicking on Get It Free From Chrome Web Store, you will be redirected to the Progress extension in the Web Store.
4. By clicking the Add to Chrome button, the extension will be added after confirmation.
5. Click on the icon located to the right of the address bar to find the extension's version.
Follow the steps below to manually configure Chrome for web automation with Test Studio.
Enable Extensions
1. Click on
located in the upper right corner of the browser. Then select More tools > Extensions.2. Ensure that the Progress Test Studio Extension is enabled.
Zoom Level Set to 100%
1. Click on in the upper right corner.2. Use the plus (+) and minus (-) buttons next to Zoom to set it to 100% (or use the keyboard shortcut: Ctrl + 0).
Enable File Downloads
1. Click on in the upper right corner.2. Select Settings from the drop-down menu.
3. Scroll to the bottom and click Advanced.
4. Locate the Downloads section.
5. Enable Ask where to save each file before downloading.
Disable Pop-up Blocker
1. Click on in the upper right corner.2. Select Settings from the drop-down menu.
3. Scroll to the bottom and click Advanced.
4. Locate the Privacy and security section.
5. Click Content Settings.
6. Under Popups section enable Allowed.
Allow All Sites to Run JavaScript
1. Click on in the upper right corner.2. Select Settings from the drop-down menu.
3. Scroll to the bottom and click Advanced.
4. Locate the Privacy and security section.
5. Click Content Settings.
6. Under JavaScript enable Allowed.
Unblock Third-Party Cookies and Site Data
1. Click on in the upper right corner Settings > Advanced > Privacy and security > Content Settings > Cookies .2. Enable Allow sites to save and read cookie data (recommended).
3. Disable Block third-party cookies.
Allow all Sites to Download Multiple Files Automatically
1. Click on in the upper right corner > Settings > Advanced > Privacy and security > Content Settings.2. Under Automatic Downloads section enable Allow all sites to download multiple files automatically .
Allow All Sites to Open PDF Files Externally
1. Click on in the upper right corner > Settings > Privacy and security > Content Settings > Additional content settings.2. Under PDF documents section enable Download PDF files instead of automatically opening them in Chrome .
Disable Web Security
1. Open the default Chrome user data folder under your Windows account - "C:\Users\[WindowsUser]\AppData\Local\Google\Chrome\User Data\Default" and locate the Preferences file.
2. Open it with a text editor and search for "webkit". If there is no such preference in the file, add the following at the bottom of the file:
"webkit":{"webprefs":{"web_security_enabled":false}}
If the "webkit" preference already exists in the Preferences file and has any value in the "webprefs", you can add the web security as follows:
Existing values listed in the file:
"webkit":{"webprefs":{"minimum_font_size":6}}
The file after adding the web security:
"webkit":{"webprefs":{"minimum_font_size":6, "web_security_enabled":false}}