A simple and easy way to spin-up any automated browser session in any platform

Why do we need to have webdriver manager for selenium projects?

Usually when we are doing Web UI automation, we will use chrome browser and we will create environment variable for the chrome driver binary file.

System.setProperty("webdriver.chrome.driver", projectDir + "\binaries\chromedriver.exe");
WebDriver driver = new ChromeDriver();
String baseUrl = "https://www.google.com";
driver.get(baseUrl);"

Drawbacks of this implementation:

1. Chrome driver is stored in the project folder (EXEs are vulnerable)
2. Chrome driver version need to update manually for the new chrome releases
3. Only works in Windows operating systems
4. Need to have more codes to run on other operating systems
5. Need to change this code to run on headless mode
6. Only run in Chrome browser
7. Need to have more codes to run on other browsers
8. Hard to scale for the real projects requirements

MaxSoft-WebDriver Manager is developed to overcome these issues.

Technologies/Frameworks used

• Java
• Selenium
• Bonigarcia WebDriverManager
• Junit
• Apache Maven

Supported Platforms

• Windows
• Linux
• Mac OS

Supported Languages

• Java

Advantages

• No need of any configurations
• All browsers are embedded
• Easy to use
• Platform independent

Pre Requisites

1. Java
2. Maven

How to use MaxSoft — WebDriver Manager?

Step by step guide:

1. Go to your Selenium maven project’s pom.xml file.
2. Add below tags

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.osandadeshan</groupId>
        <artifactId>maxsoft-webdriver-manager</artifactId>
        <version>1.2.0</version>
    </dependency>
</dependencies>

3. Now in your test class, you can instantiate WebDriver with your preffered browser.

WebDriver driver = DriverFactory.getDriver("chrome");

As the parameter of above line, you can use “chrome”, “headless-chrome”, “firefox”, “headless-firefox”, “ie”, “edge”, “safari”

Ex 1: For Chrome browser

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:00 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for chrome driver
 **/


public class ChromeDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a driver instance of chrome browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(BrowserType.CHROME);
        driver.manage().window().maximize();
    }

    @Test
    public void testChromeDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.CHROME, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the chrome driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 2: For Chrome browser — Headless Mode

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:24 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for chrome headless driver
 **/


public class ChromeHeadlessDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a headless driver instance of chrome browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.HEADLESS_CHROME);
        driver.manage().window().maximize();
    }

    @Test
    public void testChromeHeadlessDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.CHROME, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the chrome headless driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 3: For Firefox browser

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:13 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for firefox driver
 **/


public class FireFoxDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a driver instance of firefox browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.FIREFOX);
        driver.manage().window().maximize();
    }

    @Test
    public void testFireFoxDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.FIREFOX, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the firefox driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 4: For Firefox browser — Headless Mode

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:27 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for firefox headless driver
 **/


public class FireFoxHeadlessDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a headless driver instance of firefox browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.HEADLESS_FIREFOX);
        driver.manage().window().maximize();
    }

    @Test
    public void testFireFoxHeadlessDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.FIREFOX, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the firefox headless driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 5: For Internet Explorer browser

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:31 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for internet explorer driver
 **/


public class InternetExplorerDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a driver instance of internet explorer browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.IE);
        driver.manage().window().maximize();
    }

    @Test
    public void testInternetExplorerDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.IE, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the internet explorer driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 6: For Edge browser

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:33 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for edge driver
 **/


public class EdgeDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a driver instance of edge browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.EDGE);
        driver.manage().window().maximize();
    }

    @Test
    public void testEdgeDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.EDGE.toLowerCase(), runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the edge driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Ex 7: For Safari browser

package com.maxsoft.webdrivermanager.driver.test;

import com.maxsoft.webdrivermanager.driver.DriverFactory;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.Capabilities;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.remote.BrowserType;
import org.openqa.selenium.remote.RemoteWebDriver;

/**
 * Project Name    : maxsoft-webdriver-manager-demo
 * Developer       : Osanda Deshan
 * Version         : 1.0.0
 * Date            : 3/15/2020
 * Time            : 10:33 AM
 * Description     : This is an example of how to use maxsoft-webdrivermanager for safari driver
 **/


public class SafariDriverTest extends TestBase {

    // Holds the WebDriver instance
    public static WebDriver driver;

    // Initialize a driver instance of safari browser
    @Before
    public void initializeDriver() {
        driver = DriverFactory.getDriver(DriverFactory.SAFARI);
        driver.manage().window().maximize();
    }

    @Test
    public void testSafariDriver() {
        Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();
        String runningBrowserName = cap.getBrowserName().toLowerCase();
        Assert.assertEquals(BrowserType.SAFARI, runningBrowserName);

        driver.get("http://automationpractice.com/");
        Assert.assertEquals("My Store", driver.getTitle());
    }

    // Close the safari driver instance
    @After
    public void closeDriver() {
        driver.quit();
    }
}

Happy Automation !!!

MaxSoft — WebDriver Manager was originally published in MaxSoft — WebDriver Manager on Medium, where people are continuing the conversation by highlighting and responding to this story.