Calibrate Browsers
To be able to run tests using Test Studio Dev against any browser it needs to be configured accordingly. In this article you can find the required settings for each of the supported browsers which will ensure flawless and consistent automation process.
Built-in Calibration
We call that browser is calibrated if the required settings are applied. Test Studio Dev provides a built-in configuration approach which will set all necessary settings for the supported browsers out of the box and no manual interaction is required. To use our built-in feature open the Test Studio Dev Settings window and switch to its Browser tab.
In the Browser tab there is a list with the installed browsers on the current machine with a Calibrate/Restore button next to each. If a browser is successfully calibrated the button allows you to restore its previous settings.
If a browser is not yet configured the button allows you to calibrate it.
Note! During browser calibration Test Studio Dev will automatically close all of currently running browser instances. Therefore before proceeding with calibration ensure there is no important information you might lose if browser gets closed.
Note! if you need to check the settings applied from Test Studio Dev, you can scroll to the bottom of the article and check the section for Manual Browser Calibration.
Install Extensions for Firefox, Chrome and Micorosft Edge Chromium
Chrome and Firefox browsers require an extension for the purposes of automation testing with Test Studio Dev.
The Chrome extension can be found in the Chrome web store - Progress Test Studio Extension.
The Firefox extension can be found in the Firefox Add-ons Page - Progress Test Studio Extension.
The Edge Chromium browser can now use extensions from the Chrome store and this will be used until Test Studio extension is published in the official Edge store. The extension is listed in the Chrome web store - Progress Test Studio Extension.
Accept Extension Permission for Version 2020.2.728
WIth the latest 2020 R2 Test Studio release (v.2020.2.804) a corresponding version of the extensions for Chrome, Edge Chromium and Firefox is published and their latest version is now 2020.2.728.1. As these require to allow additional permissions, the updated extension will be disabled.
To re-enable it, you need to manually accept the permissions request for each browser and machine. When you open the browser, there is a warning sign on the Settings menu.
Open the Settings menu and click on the message that the Test Studio extension is disabled.
Click the notification message and a Popup appears to confirm if you accept the requested permissions and re-enable the Test Studio extension.
Add WebDriver for Microsoft Edge (if Still Using the Old Version of MS Edge)
The deprecated version of MS Edge gets replaced once you install the new Microsoft Edge Chromium. If you still haven't upgraded to it, you can use the previous version of the browser. In order to use the MS Edge browser for Test Studio automation you need to install Microsoft WebDriver. Depending on your Windows 10 build you should choose the correct WebDriver.
Determine your Windows 10 build and download the correct MS WebDriver from here.
Windows 10 Anniversary Update (build 14393) And Later
Note! The following steps apply for Windows 10 Anniversary Update (build 14393) and later. If you don't use it skip to the Automatic Calibration step.
Microsoft WebDriver for that particular build doesn't include installer (*.msi) but only *.exe file. You should manually locate the WebDriver exe file in the Test Studio project settings.
Windows versions prior Windows 10 Anniversary Update
1.1 Download Microsoft WebDriver for release 14393 from here and save it on your computer.
1.2 Locate WebDriver from the Project Settings -> Browsers
1.3 Navigate to the download location and select WebDriver exe file.
1.4 The location of WebDriver is now successfully set
Manual Settings to Configure a Browser
Internet Explorer
If you need to double check manually if all settings are correct expand the Manual Configuration section below.
Zoom Level Set to 100%
1. Go to the higher right of the browser.2. Click Tools button -> Zoom.
3. Select 100% (or use the keyboard shortcut: Ctrl + 0).
Disable Protected Mode
1. Click Tools > Internet Options.2. Click the Security tab.
3. Uncheck the Enable Protected Mode checkbox.
4. Repeat step 3 for:
- Internet
- Local intranet
- Trusted sites
Disable Pop-up Blocker
1. Click Tools > Internet Options2. Click the Privacy tab.
3. Uncheck the Turn on Pop-up Blocker checkbox.
Pop-ups Open in a New Window
1. Click Tools > Internet Options.2. On the General tab, click the Settings button for Change how webpages are displayed in tabs.
3. Select Always open pop-ups in a new window.
Add the Websites to List of Trusted Sites
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click on Trusted sites.
4. Click the Sites button.
5. If your site is not secure (uses HTTPS protocol), then uncheck the Require server verification... checkbox.
6. Enter the URL of your website in Add this website to the zone text box. This text box will accept both DNS names and IP addresses.
7. Click Add.
8. Repeat steps 6-7 for each website you'll be testing.
Disable Trusted Sites Message
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click Trusted sites and then Custom level.
4. Scroll down until you find the Websites in less privileged web content zone can navigate into this zone under the Miscellaneous heading.
5. Check Enable.
Ensure JavaScript Is Enabled
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click Trusted sites and then Custom level.
4. Scroll down until you find the Active scripting setting under the Scripting heading.
5. Check Enable.
Disable Mixed Content Message
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click Trusted sites and then Custom level.
4. Scroll down until you find the Display mixed content setting under the Micellaneous heading.
5. Check Enable.
Enable File Downloads
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click Trusted sites and then Custom level.
4. Scroll down until you find the File download setting under the Downloads heading.
5. Check Enable.
6. Repeat steps 3 - 5 for the Local intranet and the Internet zones.
For IE7 and IE8 file downloads, uncheck Close this dialog box when download completes. The only way to do this is to actually start downloading something and uncheck this checkbox while the download is running.
For __IE9__ downloads, check __Notify me when my downloads are complete__:
1. Click Tools > View downloads.
2. Click the Options link in the lower left.
3. Check Notify me when my downloads are complete.
4. Click OK
Allow Local Files to Run Unhindered
1. Click Tools > Internet Options.2. Click the Advanced tab.
3. Check Allow active content to run in files on My Computer under the Security heading.
Turn Off AutoComplete
1. Click Tools > Internet Options.2. Click the Content tab.
3. Click the Settings button under the AutoComplete section.
4. In AutoComplete Settings, uncheck Forms and User names and passwords on forms.
Windows updates
The latest Internet Explorer updates should be installed.Note: Installing KB2987107 security update for Internet Explorer 11 helps some customers with recording issues.
Add http://www.w3.org to Trusted Sites
1. Click Tools > Internet Options.2. Click the Security tab.
3. Click Trusted sites.
4. Add http://www.w3.org to the trusted sites.
Chrome
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.
Enable Extensions
1. Click on
located in the upper right corner of the browser 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 .
Disable Web Security
1. Open the Default Chrome User data folder under the 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}}
Microsoft Edge Chromium
If you need to double check manually if all settings are correct expand the Manual Configuration section below.
Enable Extensions
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser Settings -> Extensions.2. Ensure that the Progress Telerik Test Studio Extension is enabled.
Zoom Level Set to 100%
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Use the plus (+) and minus (-) buttons next to Zoom to set it to 100%.
Enable File Downloads
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Settings from the drop-down menu.
3. Locate the Downloads section.
4. Enable Ask where to save each file before downloading.
Disable Pop-up Blocker
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Settings from the drop-down menu.
3. Locate the Site Permissions section.
4. Open the Pop-ups and redirects section.
5. Disable the Block option.
Allow All Sites to Run JavaScript
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Settings from the drop-down menu.
3. Locate the Site Permissions section.
4. Open the JavaScript section.
5. Enable the Allowed option.
Unblock Third-Party Cookies and Site Data
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Settings from the drop-down menu.
3. Locate the Site Permissions section.
4. Open the Cookies and site data section.
5. Enable the Allow sites to save cookies option.
6. Disable the Block third-party cookies option.
Allow all Sites to Download Multiple Files Automatically
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Settings from the drop-down menu.
3. Locate the Site Permissions section.
4. Open the Automatic downloads section.
5. Enable the Ask when site tries to download multiple files option.
Allow Extension from Other Stores
1. Click on Edge browser *Settings* button - the three dots located in the upper right corner of the browser.2. Select Extensions from the drop-down menu.
3. Locate the Site Permissions section.
4. Enable the Allow extensions from other stores option.
FireFox
If you need to double check manually if all settings are correct expand the Manual Configuration section below.
Enable Progress Test Studio Extension
1. Click on browser settings in the right upper corner and press on Add-ons.
2. Ensure that the Progress Test Studio Extension is enabled.
Zoom Level Set to 100%
1. Click on browser settings.2. Use the plus (+) and minus (-) buttons to set it to 100%.
Turn Off Pop-up Blocker & Enable JavaScript
1. Click on browser settings and press on Options.
2. Click on the Privacy and Security tab (on the left side) and scroll down to Permissions section.
3. Uncheck the Block pop-up windows checkbox.
Pop-ups Open in a New Tab
1. Click on browser settings and press on Options.2. Scroll down to Tabs section and check Open new windows in a new tab instead.
Enable File Downloads
1. Click on browser settings and press on Options.2. Scroll down to Downloads section and check and select Always ask you where to save files.
Enable Cookies
1. Click on browser settings and press on Options.2. Click on the Privacy and Security.
3. Scroll down to History section to set the option to Remember history.
Disable 'Remember passwords for sites'
1. Click on browser settings and press on Options.2. Click on the Privacy and Security.
3. Make sure the Remember logins and passwords for websites option is disabled.
Use System Proxy Settings
As of the 2012 R1 version released in April 2012, set the Connection Settings to Use system proxy settings.1. Click on browser settings and press on Options.
2. Click on the General.
3. Scroll down to Network Proxy section and press on Settings... button.
4. In the Connection Settings window select Use system proxy settings.
Setting Configuration Flags
There are three more settings to be modified in the configuration editor - type about:config in the url bar and press Enter to access it. Double click the following settings to set these to false:- browser.sessionstore.resume_from_crash
- browser.tabs.warnOnClose
- browser.tabs.warnOnCloseOtherTabs
Disable Conflicting Extensions
The following Add-ons are known to conflict with the Progress Test Studio Extension:- AOL Messaging Toolbar
- FoxyProxyStandard
Microsoft Edge
If you need to double check manually if all settings are correct expand the Manual Configuration section below.
Zoom Level Set to 100%
1. Go to the higher right of the browser and click on the 3 dots button.2. Select 100% zoom (or use the keyboard shortcut: Ctrl + 0).
Hide The Favorites Bar
This bar conflicts with highlighting coordinates.1. Go to the higher right of the browser and click on the 3 dots button.
2. Click Settings and then View favorite settings.
3. Set Show the favorites bar to Off.
Open New Tabs With A Blank Page
1. Go to the higher right of the browser and click on the 3 dots button.2. Click Settings.
3. Set Open new tabs with to A blank page.
Disable Password Save Offering
1. Go to the higher right of the browser and click on the 3 dots button.2. Click Settings and then View advanced settings.
3. Set Offer to save passwords and Save for entries to Off.
Allow Cookies
1. Go to the higher right of the browser and click on the 3 dots button.2. Click Settings and then View advance settings.
3. Set Cookies to Don't block cookies.
Safari
If you need to double check manually if all settings are correct expand the Manual Configuration section below.
Zoom Level Set to 100%
1. Click the Page icon and then select Zoom.2. Choose Actual Size (or use the keyboard shortcut: Ctrl + 0).
Enable File Downloads
1. Click the Tools icon and then select Preferences from the drop-down menu.2. Click on the General tab.
3. Make sure that Always prompt before downloading is checked.
Disable Pop-up Blocker, Enable Plug-ins, Accept Cookies, Enabled JavaScript, & No Mixed Content Prompt
1. Click the Tools icon and then select Preferences from the drop-down menu.2. Click on the Security tab.
3. Make sure that Enable JavaScript is checked.
4. Make sure that Block pop-up windows is unchecked.
5. Make sure Always is selected.
6. Make sure Ask before sending a non-secure form to a secure website is unchecked.
Enable Extensions
1. Click the Tools icon and then select Preferences from the drop-down menu.2. Click on the Extensions tab.
3. Make sure that Extensions is set to On.
4. Make sure that the Telerik Test Studio Automation Extension extension is enabled.
Pop-ups Open in a New Window
1. Click the Tools icon and then select Preferences from the drop-down menu.2. Click on the Tabs tab.
3. Set Open pages in tabs instead of windows to Never.
4. Place a check by When a new tab or window opens, make it active.
Never Block Cookies
1. Click the Tools icon and then select Preferences from the drop-down menu.2. Click on the Privacy tab.
3. Under the Block cookies section, select Never.
