WebDriverManager 2.12.2

Install-Package WebDriverManager -Version 2.12.2
dotnet add package WebDriverManager --version 2.12.2
<PackageReference Include="WebDriverManager" Version="2.12.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add WebDriverManager --version 2.12.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: WebDriverManager, 2.12.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install WebDriverManager as a Cake Addin
#addin nuget:?package=WebDriverManager&version=2.12.2

// Install WebDriverManager as a Cake Tool
#tool nuget:?package=WebDriverManager&version=2.12.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Build status Quality Gate Coverage NuGet

WebDriverManager.Net

Table of contents

Info

This small library aimed to automate the Selenium WebDriver binaries management inside a .Net project.

If you have ever used Selenium WebDriver, you probably know that in order to use some browsers (for example Chrome) you need to download a binary which allows WebDriver to handle the browser. In addition, the absolute path to this binary must be set as part of the PATH environment variable or manually copied to build output folder (working directory).

This is quite annoying since it forces you to link directly this binary in your source code. In addition, you have to check manually when new versions of the binaries are released. This library comes to the rescue, performing in an automated way all this dirty job for you.

WebDriverManager is open source, released under the terms of MIT license.

Installation

WebDriverManager.Net can be downloaded from NuGet. Use the GUI or the following command in the Package Manager Console:

PM> Install-Package WebDriverManager

Usage

Target is netstandard2.0.

After installation you can let WebDriverManager.Net to do manage WebDriver binaries for your application/test. Take a look to this NUnit example which uses Chrome with Selenium WebDriver:

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using WebDriverManager;
using WebDriverManager.DriverConfigs.Impl;

namespace Test
{
    [TestFixture]
    public class Tests
    {
        private IWebDriver _webDriver;

        [SetUp]
        public void SetUp()
        {
            new DriverManager().SetUpDriver(new ChromeConfig());
            _webDriver = new ChromeDriver();
        }

        [TearDown]
        public void TearDown()
        {
            _webDriver.Quit();
        }

        [Test]
        public void Test()
        {
            _webDriver.Navigate().GoToUrl("https://www.google.com");
            Assert.True(_webDriver.Title.Contains("Google"));
        }
    }
}

Notice that simply adding new DriverManager().SetUpDriver(<config>) does magic for you:

  1. It checks the latest version of the WebDriver binary file
  2. It downloads the binary WebDriver if it is not present in your system

So far, WebDriverManager supports Chrome, Microsoft Edge, Firefox(Marionette), Internet Explorer, Opera or PhantomJS configs (Just change <config> to prefered config):

new ChromeConfig();
new EdgeConfig();
new FirefoxConfig();
new InternetExplorerConfig();
new OperaConfig();
new PhantomConfig();

Advanced

You can use WebDriverManager in two ways:

  1. Automatic
  2. Manual
Automatic way:
new DriverManager().SetUpDriver(new <Driver>Config());

You can also specify version:
new DriverManager().SetUpDriver(new ChromeConfig(), "2.25")

Or architecture:
new DriverManager().SetUpDriver(new ChromeConfig(), "Latest", Architecture.X32)

Or version and architecture:
new DriverManager().SetUpDriver(new ChromeConfig(), "2.25", Architecture.X64)

Only for Google Chrome so far, you can specify to automatically download a chromedriver.exe matching the version of the browser that is installed in your machine:
new DriverManager().SetUpDriver(new ChromeConfig(), VersionResolveStrategy.MatchingBrowser);

Manual way:
new DriverManager().SetUpDriver(
    "https://chromedriver.storage.googleapis.com/2.25/chromedriver_win32.zip",
    Path.Combine(Directory.GetCurrentDirectory(), "chromedriver.exe"),
    "chromedriver.exe"
);

If you want use your own implementation you need to create driver config and use it for set up(ex get, setup and work with phantomjs driver from taobao mirror):

public class TaobaoPhantomConfig : IDriverConfig
{
    public string GetName()
    {
        return "TaobaoPhantom";
    }

    public string GetUrl32()
    {
        return "https://npm.taobao.org/mirrors/phantomjs/phantomjs-<version>-windows.zip";
    }

    public string GetUrl64()
    {
        return GetUrl32();
    }

    public string GetBinaryName()
    {
        return "phantomjs.exe";
    }

    public string GetLatestVersion()
    {
        using (var client = new WebClient())
        {
            var doc = new HtmlDocument();
            var htmlCode = client.DownloadString("https://bitbucket.org/ariya/phantomjs/downloads");
            doc.LoadHtml(htmlCode);
            var itemList =
                doc.DocumentNode.SelectNodes("//tr[@class='iterable-item']/td[@class='name']/a")
                    .Select(p => p.InnerText)
                    .ToList();
            var version = itemList.FirstOrDefault()?.Split('-')[1];
            return version;
        }
    }
}

...

new DriverManager().SetUpDriver(new TaobaoPhantomConfig());

Also you can implement your own services for download binaries and manage variables:

public class CustomBinaryService : IBinaryService
{
    public string SetupBinary(string url, string zipDestination, string binDestination, string binaryName)
    {
        ...
        // your implementation
        ...
    }
}

public class CustomVariableService : IVariableService
{
    public void SetupVariable(string path)
    {
        ...
        // your implementation
        ...
    }
}

...

new DriverManager(new CustomBinaryService(), new CustomVariableService()).SetUpDriver(new FirefoxConfig());

Or you can modify existed drivers and change only necessary fields(same example):

public class TaobaoPhantomConfig : PhantomConfig
{
    public override string GetName()
    {
        return "TaobaoPhantom";
    }

    public override string GetUrl32()
    {
        return "https://npm.taobao.org/mirrors/phantomjs/phantomjs-<version>-windows.zip";
    }
}

...

new DriverManager().SetUpDriver(new TaobaoPhantomConfig());

Using with proxy:

new DriverManager().WithProxy(previouslyInitializedProxy).SetUpDriver(new ChromeConfig());

Thanks

Thanks to the following companies for generously providing their services/products to help improve this project:

Logo Description
AppVeyor AppVeyor is a hosted, distributed continuous integration service used to build and test projects hosted at GitHub on a Microsoft Windows virtual machine.
BrowserStack BrowserStack is a cloud-based cross-browser testing tool that enables developers to test their websites across various browsers on different operating systems and mobile devices, without requiring users to install virtual machines, devices or emulators.
GitHub GitHub is a web-based Git repository hosting service. It offers all of the distributed version control and source code management (SCM) functionality of Git as well as adding several collaboration features such as bug tracking, feature requests, task management, and wikis for every project.
JetBrains JetBrains (formerly IntelliJ) is a software development company whose tools are targeted towards software developers and project managers.
SonarQube SonarQube (formerly Sonar) is an open source platform for continuous inspection of code quality to perform automatic reviews with static analysis of code to detect bugs, code smells and security vulnerabilities on 20+ programming languages.

About

WebDriverManager.Net (Copyright © 2016-2021) is a personal project of Aliaksandr Rasolka licensed under MIT license. Comments, questions and suggestions are always very welcome!

NuGet packages (20)

Showing the top 5 NuGet packages that depend on WebDriverManager:

Package Downloads
JDI.UIWeb

Framework for Web UI Automation Testing

Aquality.Selenium

Wrapper over Selenium WebDriver for .NET

Magenic.Maqs.Selenium

Magenic's automation quick start framework

TAF.WebSupport

Web support for the TAF test automation framework by Zington

ApexChat.TestSystem.Core

Infrastructure code for Mobile and Web Test Automation

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on WebDriverManager:

Repository Stars
AutomateThePlanet/AutomateThePlanet-Learning-Series
Automate The Planet Series Source Code
Version Downloads Last updated
2.12.2 12,830 10/26/2021
2.12.1 12,946 10/5/2021
2.12.0 8,719 9/16/2021
2.11.3 58,110 7/23/2021
2.11.2 9,296 6/29/2021
2.11.1 235,631 12/19/2020
2.11.0 103,036 9/21/2020
2.10.0 664 9/19/2020
2.9.3 38,323 8/2/2020
2.9.2 6,972 7/21/2020
2.9.1 78,904 4/5/2020
2.9.0 56,022 1/23/2020
2.8.0 2,683 1/20/2020
2.7.0 40,117 10/24/2019
2.6.0 69,826 9/1/2019
2.5.1 54,887 6/22/2019
2.5.0 2,247 5/22/2019
2.4.0 1,142 5/9/2019
2.3.1 3,989 4/10/2019
2.3.0 6,647 1/16/2019
2.2.8 779 1/9/2019
2.2.7 20,878 9/3/2018
2.2.6 31,895 7/8/2018
2.2.5 2,587 3/9/2018
2.2.4 2,209 11/25/2017
2.2.3 6,628 9/6/2017
2.2.2 688 9/5/2017
2.2.1 22,776 4/28/2017
2.2.0 886 3/7/2017
2.1.0 3,667 1/16/2017
2.0.1 785 1/14/2017
2.0.0 4,170 11/21/2016
1.3.0 727 11/11/2016
1.2.3 631 11/10/2016
1.2.2 779 10/30/2016
1.2.1 991 9/6/2016
1.2.0 780 8/29/2016
1.1.3 948 6/27/2016
1.1.2 945 6/24/2016
1.1.1 847 6/6/2016
1.1.0 888 5/27/2016
1.0.0 980 5/22/2016

Fix firefox and opera configs