Skip to content

Epiphrin/UndetectedChromeDriver

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Example

using SeleniumUndetectedChromeDriver;
using (var driver = UndetectedChromeDriver.Create(
    driverExecutablePath: @"D:\xxx\chromedriver.exe"))
{
    driver.GoToUrl("https://nowsecure.nl");
}

Automatically download the chrome driver.

using (var driver = UndetectedChromeDriver.Create(
    driverExecutablePath: 
        await new ChromeDriverInstaller().Auto()))

If your chrome is not in default path, you can use browserExecutablePath to set.

using (var driver = UndetectedChromeDriver.Create(
    ...
    browserExecutablePath: @"C:\xxx\chrome.exe"))

Options example

var options = new ChromeOptions();
options.AddArgument("--mute-audio");

using (var driver = UndetectedChromeDriver.Create(
    ...
    options: options))

Options cannot be shared, you need to create a new one every time.

var createOptions = () =>
{
    var options = new ChromeOptions();
    ...
    return options;
};
var driver1 = UndetectedChromeDriver.Create(
    options: createOptions());
var driver2 = UndetectedChromeDriver.Create(
    options: createOptions());

UserDataDir example

var userDataDir = @"D:\xxx\ChromeUserData";
using (var driver = UndetectedChromeDriver.Create(
    ...
    userDataDir: userDataDir))

WPF example

public partial class MainWindow : Window
{
    private UndetectedChromeDriver _driver;
    public MainWindow()
    {
        InitializeComponent();
        this.Loaded += MainWindow_Loaded;
        this.Closed += MainWindow_Closed;
    }

    private void MainWindow_Loaded(object sender, RoutedEventArgs e)
    {
        var driverExecutablePath = $@"D:\xxx\chromedriver.exe";

        _driver = UndetectedChromeDriver.Create(
            driverExecutablePath: driverExecutablePath,
            // hide selenium command prompt window  
            hideCommandPromptWindow: true);
    }

    private void MainWindow_Closed(object? sender, EventArgs e)
    {
        _driver.Dispose();
    }

    private void Button_Click(object sender, RoutedEventArgs e)
    {
        _driver.GoToUrl("https://nowsecure.nl");
    }
}

Prefs example

// 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(
    ...
    prefs: prefs))

Multiple instance example

// options cannot be shared
var options1 = new ChromeOptions();
var options2 = new ChromeOptions();

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

using (var driver1 = UndetectedChromeDriver.Create(
    ...
    options: options1,
    userDataDir: userDataDir1))

using (var driver2 = UndetectedChromeDriver.Create(
    ...
    options: options2,
    userDataDir: userDataDir2))

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.

  • port: int, optional, default: 0
     Set the port used by the chromedriver executable. (not debugger port)

  • 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.

  • noSandbox: bool, optional, default: true
     Set use --no-sandbox, and suppress the "unsecure option" status bar.
     this option has a default of true since many people seem to run this as root(....) ,
     and chrome does not start when running as root without using --no-sandbox flag.

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

  • hideCommandPromptWindow: bool, optional, default: false
     Hide selenium command prompt window.

  • commandTimeout: TimeSpan, optional, default: null
     The maximum amount of time to wait for each command.
     default value is 60 seconds.

  • 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.

  • configureService: Action<ChromeDriverService>, optional, default: null
     Initialize configuration ChromeDriverService.


Chrome argument example

// Set language.
options.AddArguments("--lang=en");
// Set screen.
options.AddArguments("--window-size=1920,1080");
options.AddArguments("--start-maximized");
// Enable geolocation.
var prefs = new Dictionary<string, object>
{
    ["profile.default_content_setting_values.geolocation"] = 1
};

using (var driver = UndetectedChromeDriverCreate(
    ...
    prefs: prefs))
// Set geolocation.
driver.ExecuteCdpCommand(
    "Emulation.setGeolocationOverride",
    new Dictionary<string, object>
    {
        ["latitude"] = 42.1408845,
        ["longitude"] = -72.5033907,
        ["accuracy"] = 100
    });
// Set timezone.
driver.ExecuteCdpCommand(
    "Emulation.setTimezoneOverride",
    new Dictionary<string, object>
    {
        ["timezoneId"] = "America/New_York"
    });
// Disable WebGL.
options.AddArgument("--disable-gpu");
options.AddArgument("--disable-software-rasterizer");
// Disable WebRTC.
var prefs = new Dictionary<string, object>
{
    ["webrtc.ip_handling_policy"] = "disable_non_proxied_udp",
    ["webrtc.multiple_routes_enabled"] = false,
    ["webrtc.nonproxied_udp_enabled"] = false
};
using (var driver = UndetectedChromeDriverCreate(
    ...
    prefs: prefs))
// Add Extensions.
var extension1 = @"D:\ChromeExtensions\Extension1";
var extension2 = @"D:\ChromeExtensions\Extension2";
options.AddArgument($"--load-extension={extension1},{extension2}");

Network capture

// import dev tools version
using DevToolsVer = OpenQA.Selenium.DevTools.V103;

// capture iframe
options.AddArgument("--disable-features=IsolateOrigins,site-per-process");

// log request url
var devTools = ((IDevTools)driver).GetDevToolsSession()
    .GetVersionSpecificDomains<DevToolsVer.DevToolsSessionDomains>();
await devTools.Network.Enable(new DevToolsVer.Network.EnableCommandSettings());
devTools.Network.RequestWillBeSent += (sender, e) =>
{
    Console.WriteLine(e.Request.Url);
};

Suppress initial information

using (var driver = UndetectedChromeDriver.Create(
    ...
    configureService: (service) =>
    {
        // Suppress chrome driver initial information.
        service.SuppressInitialDiagnosticInformation = true;
    }))

Get cookies

var cookies = string.Join("; ",
    driver.Manage().Cookies.AllCookies
        .Select(it => $"{it.Name}={it.Value}"));

Add cookies

driver.GoToUrl("url");

driver.Manage().Cookies.AddCookie(
    new OpenQA.Selenium.Cookie("TestCookie", "TestCookieValue"));

driver.GoToUrl("url");

Get user agent

var userAgent = driver.ExecuteJavaScript<string>(
    "return navigator.userAgent;");

Use proxy

options.AddArguments("--proxy-server=192.168.1.100:2048");
options.AddArguments("--proxy-server=socks5://192.168.1.100");

Move off screen

options.AddArgument(@"--window-position=""10000,10000""");

Declare

This repo is not an official undetected_chromedriver product.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%