How to Set Up and Troubleshoot Webdrivers

How to Set Up and Troubleshoot Webdrivers

Initial Webdriver Setup

In order to use Cycle web Steps, a driver must be installed for Chrome, Internet Explorer, or Microsoft Edge.

 

Step 1: Download your Webdriver

The downloads for Chromedriver and IEDriver can be found from Chromium and Selenuim at the following links:

Chromedriver

InternetExplorerDriver (Use the 32 bit driver for best performance)

The Chrome webdriver is typically named chromedriver.exe and the Internet Explorer webdriver is typically named IEDriverServer.exe These drivers can be saved to anywhere on the hard drive, as long as you know the path to the location.

The Driver for Microsoft Edge is included with Windows 10 but must be installed to use.  To do this first open a Command Prompt window as an Administrator.

Next run this command

DISM.exe /Online /Add-Capability /CapabilityName:Microsoft.WebDriver~~~~0.0.1.0

 The driver for Microsoft Edge is now installed.

Step 2: Configure Cycle Settings to Use 

Once you have downloaded a given webdriver, you will need to update the driver location in Cycle Settings. The location must be exact for each browser’s webdriver, and must include the name of the driver, as shown in the image below.

With a Cycle Project open, click the Project Settings button:

Project Settings button

Then navigate to:

Project Settings > Execution Settings > Web Drivers & Browser

Set webdriver location

If using Microsoft Edge, the driver will be located at C:\Windows\System32 and will be named MicrosoftWebDriver.exe.

There are a few additional settings related to web test execution in Cycle--one for automatically closing the web browser after a given Scenario is finished executing, and another to automatically close the web browser when exiting Cycle. It should also be noted that browsers will rely on whatever proxy settings the user is using as a default.

 

Step 3: Update Browser Settings

First, note that Cycle expects all web browsers to be installed in their default locations.

Chrome and Microsoft Edge

There are no browser settings that must be updated in Chrome or Edge.

It should be noted that any settings made in a user’s Chrome browser will not be carried over into the Cycle-generated Chrome browser, because Chrome settings are tied to user profiles.

Internet Explorer

In order for Cycle to work with the Internet Explorer web browser, you must open Internet Explorer and verify the following:

  • First, in Internet Explorer, go to Settings > Zoom and ensure that zoom is set to 100%.

  • Next, go to Settings > Internet Options > Security, and verify "Enable Protected Mode" is checked for the Internet, Local intranet, Trusted sites, and Restricted sites zones. It is recommended that “Enable Protected Mode” be kept on (checked), but it can also be turned off. If it is turned off, it must be unchecked for all four zones.

 

Internet Explorer security settings
Internet Explorer security settings

 

  • Finally, add the sites you wish to access to the Trusted sites zone by going to Settings Menu > Internet Options > Security > Trusted sites and and clicking the "Sites" button. Add the domain of the website you wish to access to the Trusted sites list. It is very important that you add the domains you wish to test to the Trusted sites list. You must also verify that the Security level for the Trusted sites zone is not set to “High”.

 

Update Trusted sites list

    • Related Articles

    • My web-based Cycle tests are failing.

      Problem My browser-based Cycle Features are failing. Solution Check that the following common mistakes are not causing your failures: 1. Opening the browser first Any browser-based Steps in Cycle should be preceded in their Scenario with: I open ...
    • How to enable the inspect element tool in the Microsoft Edge browser

      Problem The inspect element tool can be accessed in the right click menu for Chrome or Internet Explorer, but is disabled by default for Microsoft Edge and must be manually enabled. Solution Enabling inspect element can be done in two ways: 1. Once ...
    • How To Disable Chrome Auto-Update for Test Environments

      Problem Google Chrome will auto-update when a new version becomes available.  When this occurs, the Chrome Webdriver being used by Cycle will no longer match the version of Chrome and may become unstable. Solution To prevent unexpected issues, Chrome ...
    • How to make better xpaths for web tests.

      Problem My web-based steps in Cycle are not finding the elements I want them to, or finding the wrong elements and giving me false-positives. Solution When possible, it is best to define elements to interact with on a web page by a static value that ...
    • How to use Web API steps

      Web API steps introduced in Cycle 2.5 can be used to send HTTP requests to exposed web API endpoints. The Cycle Web API steps support POST and GET request methods using the JSON data format. Cycle also includes steps for handling HTTP responses ...