Lyo.Web.Automation.Playwright 2.0.0

Lyo.Web.Automation.Playwright

Playwright backend for the Lyo.Web.Automation abstractions: launches Chromium / Firefox / WebKit, owns session-scoped browser contexts, and exposes the same tab, frame, dialog, keyboard, and locator helpers as Lyo.Web.Automation.Selenium so JSON automation plans and scripted runners behave the same on both engines.

Examples

First steps

services.AddPlaywrightBrowserServiceFromConfiguration(builder.Configuration);

// per operation:
var service = sp.GetRequiredService<IPlaywrightBrowserService>();
using var session = service.CreateSession();
await session.StartBrowserAsync();
await session.Browser.NavigateAsync("https://example.com");

Flared cookie handoff (host-owned)

// Playwright does not reference Lyo.Http.Client. Copy UA/cookies in the host (see Lyo.TestConsole).
using var session = playwright.CreateSession(o => {
    o.BrowserKind = PlaywrightBrowserKind.Chromium;
    if (!string.IsNullOrWhiteSpace(flared.Session.UserAgent))
        o.UserAgents = [flared.Session.UserAgent];
    o.ProxyUrl = flaredOpts.ProxyUrl;
});
await session.StartBrowserAsync();
await session.Browser.CookieJar!.AddCookiesAsync(
    flared.Session.CookieJar.Export().Select(c => new BrowserCookie {
        Name = c.Name, Value = c.Value, Domain = c.Domain, Path = c.Path,
        Secure = c.Secure, HttpOnly = c.HttpOnly, Expiry = c.Expiry
    }));
await session.Browser.NavigateToAsync(url);

Browser layer (Browser/)

• PlaywrightBrowser. Concrete IWebAutomationBrowser (StartBrowserAsync boots Playwright and a default page); composes PlaywrightBrowserTabs, PlaywrightDialogs, PlaywrightKeyboard, PlaywrightFrameNavigator, PlaywrightFrameSelectors, PlaywrightCookieJar, PlaywrightHeaderStore.
• PlaywrightTabManager / PlaywrightBrowserTabInfo. Engine-native tab info and management.
• BrowserUrlRedaction. Query/fragment redaction used in logs when MaskSensitiveUrlsInLogs is set.
• PlaywrightWebAutomationElement. Playwright ILocator adapter for IWebAutomationElement (ClickAsync, SendKeysAsync with Fill / PressSequentially, SendKeysRawAsync, attribute reads, etc.).
• PlaywrightLocatorFactory (PlaywrightLocatorFactory.cs). Maps Lyo.Web.Automation element specs onto Playwright locators.
• Cloudflare handoff is host-owned. This package does not reference Lyo.Http.Client. After a Flared solve, the host copies solver UA onto PlaywrightBrowserOptions.UserAgents (Chromium only), the same ProxyUrl onto the context, and ILyoHttpCookieJar entries onto CookieJar. Worked example: FlaredPlaywrightHandoff.cs. Architecture: HttpClientArchitecture.drawio.

Service layer (Service/)

• IPlaywrightBrowserService. Singleton factory: CreateSession() clones service config (including BrowserKind); CreateSession(Action<PlaywrightBrowserOptions>) overlays on that clone (pin UA without resetting Firefox/Chromium). CreateSession(new PlaywrightSessionOptions()) is a full replace and defaults to Chromium. ActiveSessionCount, Dispose.
• IPlaywrightBrowserSession. Scoped session.
• PlaywrightExecutionContextFactory / PlaywrightExecutionContext. Wiring used by the automation runners.
• PlaywrightMetricTags. Constants for metric tags.

Settings (Configuration/)

Application-wide defaults live on PlaywrightBrowserOptions; PlaywrightSessionOptions is the per-session subclass passed to CreateSession. Configuration section: "PlaywrightBrowserOptions".

DI registration (Service/PlaywrightServiceExtensions.cs)

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Common.Core (direct, lyo)
• Lyo.IO.Temp (direct, lyo)
• Lyo.Web.Automation (direct, lyo)
• Microsoft.Bcl.AsyncInterfaces 10.0.5 (direct, microsoft, netstandard2.0)
• Microsoft.Extensions.Configuration.Binder 10.0.5 (direct, microsoft)
• Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 (direct, microsoft)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 (direct, microsoft)
• Microsoft.Playwright 1.59.0 (direct, microsoft)
• System.Text.Json 10.0.5 (direct, microsoft, netstandard2.0)
• Lyo.Common.Metadata (transitive, lyo)
• Lyo.Configuration (transitive, lyo)
• Lyo.Exceptions (transitive, lyo)
• Lyo.Formatter (transitive, lyo)
• Lyo.Metrics (transitive, lyo)
• Lyo.Parameters (transitive, lyo)
• DynamicExpresso.Core 2.19.3 (transitive, third-party)
• Microsoft.Extensions.Hosting.Abstractions 10.0.5 (transitive, microsoft)
• SmartFormat.NET 3.6.1 (transitive, third-party)
• System.Memory 4.6.3 (transitive, microsoft, netstandard2.0)