Browser

Stealth and Anti-Detection

Methods for reducing automation detection - CDP protection, toString overrides, dark mode, Google referrer spoofing, chromedriver patching, and stealth clicking.

WithUseStealth(StealthType) configures which anti-detection measures GPAL applies to the browser session. StealthType is a Flags enum, so multiple options can be combined with the bitwise OR operator. StealthType.CDP injects a script that hides Chrome DevTools Protocol detection signals before any page script runs. StealthType.ToStringOverride patches native function toString() output so automation-related overrides do not reveal themselves under inspection. StealthType.GoogleReferrer sets the HTTP referrer to look like the browser arrived from a Google search results page. StealthType.DarkMode launches Chrome with the force-dark-mode flag. StealthType.PatchChromeDriver patches the chromedriver binary itself to remove known automation markers before the browser launches. Use StealthType.All to enable every measure, or StealthType.None (the default) to disable stealth entirely. StealthLeftClick performs a left click while temporarily disabling the CDP Runtime domain around the click, reducing the chance the click is flagged as automated.

TIP

CDP protection, toString override, and Google referrer spoofing are applied once per browser session, the first time GoTo or Get runs. DarkMode and PatchChromeDriver take effect at browser launch, so call WithUseStealth before the first GoTo or Get.

WARNING

StealthType.CDP and StealthType.ToStringOverride have no effect when using the OttoMagic automation engine - they apply only to the Selenium and JavaScript-injection based engines.

Examples

GPAL Fluent: High-level fluent C# API

//WithUseStealth accepts a bitwise combination of StealthType flags and should be set before the first GoTo or Get call. StealthLeftClick takes the selector to click as a parameter, in addition to or instead of WithSelector.

// Enable a combination of stealth measures before navigating GPAL.Browser .WithBrowserType(BrowserType.Chrome) .WithUseStealth(StealthType.CDP | StealthType.ToStringOverride | StealthType.GoogleReferrer) .GoTo("https://example.com"); // Enable every stealth measure GPAL.Browser .WithUseStealth(StealthType.All) .GoTo("https://example.com"); // Patch chromedriver and force dark mode at launch GPAL.Browser .WithUseStealth(StealthType.PatchChromeDriver | StealthType.DarkMode) .GoTo("https://example.com"); // Stealth click on a login button GPAL.Browser .GoTo("https://example.com/login") .WithSelector("#login") .StealthLeftClick("#login");

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

Browser

Browser

Stealth and Anti-Detection

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page