Browser

Browser Settings and Engine

Methods for configuring the browser type, driver location, download behavior, network settings, and automation engine mode.

WithBrowserType sets the browser (Chrome, Edge, Firefox). WithDriverLocation specifies where the WebDriver executable is located. WithBlockPopUps, WithLoadImages, and WithOpenPDFExternally control rendering behavior. WithDownloadLocation and WithDownloadTimeoutInSec configure file downloads. WithProfileName and WithProfileDataDirectory use a specific browser profile. WithWaitOnDocumentReady and WithWaitOnIdleConnection control when GPAL considers a page fully loaded. WithUseAutomationEngine sets the base automation engine (Selenium, Puppeteer, or OttoMagic) for the entire browser session - including a Hardware (HW) variant of each (SeleniumHW, PuppeteerPortHW, PuppeteerPipeHW, OttoMagicHW) that makes every selector in the session default to real OS-level mouse and keyboard input.

TIP

WithUseAutomationEngine selects the base automation engine - PuppeteerPort (the default, via Chrome DevTools Protocol), Selenium (via WebDriver), or OttoMagic - for the whole browser session, and cannot be changed once the browser is open. Choosing one of its HW variants (e.g. SeleniumHW) makes hardware-level input the default for every selector in the session, with no per-selector setting needed. Calling WithHardware or WithJavaScript right after WithSelector (either on the Selector itself or fluently on the Browser, which applies to the most recently defined selector) overrides only how that one selector is interacted with - hardware-level emulation or direct JavaScript injection - layered on top of the active base engine, and still applies even when a *HW engine is active.

Examples

GPAL Fluent: High-level fluent C# API

//Browser settings are applied before the first GoTo or Get call. WithExistingBrowser connects to a Chrome or Edge instance started with --remote-debugging-port set to the specified port.

// Full browser setup before navigation GPAL.Browser .WithBrowserType(BrowserType.Chrome) .WithDriverLocation("C:\drivers\chromedriver.exe") .WithDownloadLocation("C:\Downloads") .WithDownloadTimeoutInSec(30) .WithLoadImages(false) .WithWaitOnIdleConnection(true) .GoTo("https://example.com"); // Connect to an already-open browser instance GPAL.Browser .WithExistingBrowser(9222) // debug port .GoTo("https://example.com");

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

Browser Settings and Engine

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page