Getting started

Shell 
dotnet add package Nullean.Cdp
dotnet add package Nullean.Cdp.Journeys
dotnet tool install --global Nullean.Cdp.Cli
  1. the library
  2. journeys, if you run them from code

The tool's command is cdp. Without installing it, dnx Nullean.Cdp.Cli <command> runs it once.

Nullean.Cdp drives a Chrome you already have: Chrome, Chrome for Testing, Chromium or Edge. Check which one it finds:

Shell 
cdp chrome

Set CDP_CHROME (or CHROME_PATH) to use a particular one. Finding Chrome lists every place it looks. GitHub's hosted runners have Chrome installed.

Drive a page

C# 
using Nullean.Cdp;

await using var browser = await Browser.LaunchAsync();
await using var context = await browser.NewContextAsync();
var page = await context.NewPageAsync();
await page.GotoAsync("http://localhost:5000/");

Console.Write(await page.SnapshotAsync(new AxSnapshotOptions { Interactive = true, Selector = "main" }));
// - heading "Fixture shop" [level=1]
// - textbox "Search"
// - checkbox "Only in stock" [checked=true]
// - combobox "Sort" [expanded=false]: Name
// ...

await page.Label("Search").FillAsync("lamp");
await page.Role("checkbox", "Only in stock").UncheckAsync();
await page.Role("button", "Go").ClickAsync();
  1. headless, temporary profile
  2. its own cookies and storage
  3. waits for any navigation it starts

Disposing the browser closes Chrome and deletes its profile. One browser serves many contexts at once, so parallel tests can share it.

Next: your first journey.