skyfyl/UndetectedChromeDriver

UndetectedChromeDriver

This repo is C# implementation of undetected_chromedriver.

It optimizes Selenium chromedriver to avoid being detected by anti-bot services.

nuget install

PM> Install-Package Selenium.UndetectedChromeDriver

namespace

using SeleniumUndetectedChromeDriver;

example

// xxx is a custom directory
var driverExecutablePath =$@"D:\xxx\chromedriver.exe";

// customized chrome options
var options = new ChromeOptions();
options.AddArgument("--mute-audio");
options.AddArgument("--disable-gpu");
options.AddArgument("--disable-dev-shm-usage");

// using keyword is required to dispose the chrome driver
using var driver = UndetectedChromeDriver.Create(
    options: options,
    driverExecutablePath: driverExecutablePath);

driver.GoToUrl("https://nowsecure.nl");

parameters

• options: ChromeOptions, optional, default: null
  Used to define browser behavior.

• userDataDir: str, optional, default: null
  Set chrome user profile directory.
  creates a temporary profile if userDataDir is null,
  and automatically deletes it after exiting.

• driverExecutablePath: str, required
  Set chrome driver executable file path. (patches new binary)

• browserExecutablePath: str, optional, default: null
  Set browser executable file path.
  default using $PATH to execute.

• logLevel: int, optional, default: 0
  Set chrome logLevel.

• headless: bool, optional, default: false
  Specifies to use the browser in headless mode.
  warning: This reduces undetectability and is not fully supported.

• suppressWelcome: bool, optional, default: true
  First launch using the welcome page.

• prefs: Dictionary<string, object>, optional, default: null
  Prefs is meant to store lightweight state that reflects user preferences.
  dict value can be value or json.

---

prefs example

// xxx is a custom directory
var driverExecutablePath =$@"D:\xxx\chromedriver.exe";

// dict value can be value or json
var prefs = new Dictionary<string, object>
{
    ["download.default_directory"] =
        @"D:\xxx\download",
    ["profile.default_content_setting_values"] =
        Json.DeserializeData(@"
            {
                'notifications': 1
            }
        ")
};

using var driver = UndetectedChromeDriver.Create(
    options: new ChromeOptions(),
    driverExecutablePath: driverExecutablePath,
    userDataDir: @"D:\xxx\ChromeUserData",
    prefs: prefs);

driver.GoToUrl("https://nowsecure.nl");

multiple instance example

// xxx is a custom directory
var driverExecutablePath = $@"D:\xxx\chromedriver.exe";

// options must be independent
var options1 = new ChromeOptions();
var options2 = new ChromeOptions();

// userDataDir must be independent
var userDataDir1 = @"D:\xxx\ChromeUserData1";
var userDataDir2 = @"D:\xxx\ChromeUserData2";

using var driver1 = UndetectedChromeDriver.Create(
    options: options1,
    driverExecutablePath: driverExecutablePath,
    userDataDir: userDataDir1);
driver1.GoToUrl("https://nowsecure.nl");

using var driver2 = UndetectedChromeDriver.Create(
    options: options2,
    driverExecutablePath: driverExecutablePath,
    userDataDir: userDataDir2);
driver2.GoToUrl("https://nowsecure.nl");