Tutorials

Launching Chrome with a Real Browser Profile

WithProfileName tells GPAL to launch Chrome using one of your existing named profiles, so the browser opens already signed into whatever accounts that profile is logged into. This tutorial shows the minimal setup for a profile-based session and what to keep in mind when a real user profile is involved.

Simple Scraper: Search, Paginate, and Save

A complete eBay search-and-scrape workflow in about twenty lines. This tutorial touches selectors, the unit-of-work model, found/not-found callbacks, pagination, and saving results to a file - a good first stop after Getting Started.

Layer-by-Layer: Click, Fill In, and Read

The same everyday operations - click an element, fill in a field, read a value - look different at each of GPAL's five layers. This tutorial walks Click and FillIn side by side across all five, then digs into Read: GPAL's GetGrid convenience, the UseAttribute selector setting that controls what GetGrid returns, and how reading a single attribute looks at each lower layer.

Behavior-Style Workflows with GPAL.Gherkin

GPAL.Gherkin lets you write the same kind of workflow as tut-simple-scraper as a Given/When/And/Then scenario - each step is a plain method, no special syntax or test framework required. This tutorial rewrites the eBay search as a behavior spec and shows how steps with parameters work.

Pacing a Workflow with WaitFor

Stepping through a native dropdown with SelectClick triggers real browser navigation between each choice. This tutorial uses that workflow to show where WaitFor belongs in a chain - right after the action that needs time to settle - and how it works whether or not WithSelector was just called.

Paging with Workflows: While and Until

WithWorkflow records a chain of AndThen calls as a repeatable block; While and Until run that block under a condition you control, and GetExecutionResults keeps every pass's named results so you can read them all back afterward - or feed one pass's result into the next pass's condition.

Downloading and Patching a Browser Driver Automatically

Selenium-based engines need a matching driver executable (chromedriver, msedgedriver, geckodriver) on disk. This tutorial uses GPAL to detect the installed browser version, find the matching driver download on the vendor's release page, download it, and unzip the driver into your drivers folder.

💬 Ask GPAL