WebDriver for Web based tests

With WebEngine there is a unique way to initialize Web Driver for any kind of platforms and any kind of browsers: <xref:AxaFrance.WebEngine.Web.BrowserFactory.GetDriver(AXA.WebEngine.Platform,AxaFrance.WebEngine.BrowserType)>

Test on desktop browsers

WebEngine support following desktop browsers:

  • Internet Explorer: (deprecated) WebEngine.Web library contains the IE WebDriver to run automated tests on Internet Explorer 11.
  • Microsoft Edge: WebEngine will automatically download and use Microsoft Edge driver from official repository according to the Edge installed on your computer.
  • Google Chrome: WebEngine will automatically download and use Chrome Driver from official repository according to the Chrome installed on your computer.
  • Mozilla FireFox: WebEngine library contains a geckodriver
var webdriver = BrowserFactory.GetDriver(AxaFrance.WebEngine.Platform.Windows, AxaFrance.WebEngine.BrowserType.ChromiumEdge);
webdriver.Navigate().GoToUrl("https://webengine-test.azurewebsites.net/");

The returned webdriver object is type of OpenQA.Selenium.WebDriver

Important
  1. Earlier EdgeHTML based Edge is abandoned by Microsoft. WebEngine support chromium-based Edge browser.
  2. Internet Explorer is no longer supported; we will remove the support of IE in future release.

Test on Mobile browsers

WebEngine support following desktop browsers:

  • Chrome: for Android devices via Appium or Selenium Grid compatible platforms.
  • Safari: for iOS based devices via Appium or Selenium Grid compatible platforms.
var webdriver = BrowserFactory.GetDriver(AxaFrance.WebEngine.Platform.Android, AxaFrance.WebEngine.BrowserType.Chrome);
webdriver.Navigate().GoToUrl("https://webengine-test.azurewebsites.net/");

The returned webdriver object is type of OpenQA.Selenium.Appium.AppiumDriver. More specifically, AndroidDriver or IOSDriver according to the device connected. It gives you the possibility to pass mobile specific commands.

To test on Mobile browsers you'll need to specify the Appium Server or Selenium Grid of which the device is connected.

For following code snippet is used to connect to a Android Device, named Nexus 5 running Android 10.1 and Chrome browser.

Parameters Username and Password will be used for Grid Authentication. Device, OsVersion will be used for device selection according to devices available in your device cloud. You can use these parameters to connect to some Device cloud providers based on Selenium Grid.

var settings = AxaFrance.WebEngine.Settings.Instance;
settings.GridServerUrl = "http://<grid-server>:<port>/wd/hub";
settings.Username = "user-of-grid";
settings.Password = "user-access-key";
settings.Device = "Nexus 5";
settings.OsVersion = "10.1";
driver = BrowserFactory.GetDriver(AxaFrance.WebEngine.Platform.Android, AxaFrance.WebEngine.BrowserType.Chrome);
driver.Navigate().GoToUrl("https://webengine-test.azurewebsites.net/");
Note

Selenium Grid connection, username and password can be configured in configuration files.

Firewall consideration

During test execution, the target machine must have access to the following internet address to download the web driver according to the browser installed.

If test execution is performed in a controlled environment, please configure either proxy or firewall rules to make sure above URLs are accessible. WebEngine framework will take account system proxy settings.