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");