Configuring Chrome for Test Studio Automation
This document describes the steps to adjust Chrome for test recording and execution.
1. Install the Progress Extensions
Install the latest Chrome extension from the Chrome Web Store:
- Test Studio 2017 R3 (v. 2017.3.1010) And Later
There is a single extension combining recording and execution: Progress Test Studio Extension.
- Test Studio 2017 R2 SP1(v. 2017.2.824) And Earlier
There are two seaprate extensions available - one for recording and one for execution - Progress Test Studio Chrome Recorder and Progress Test Studio Chrome Execution
If you face any troubles when installing or enabling the extensions please expand the Extension Install Procedure section below.
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.
If you need to double-check manually if all settings are correct, expand the Manual Configuration section below.
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.
Follow the steps below if the extension for Chrome is not automatically installed during the Test Studio installation.
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}}