.NET Playwright Proxy Integration

Playwright for .NET Proxy Setup

Microsoft Playwright for .NET brings the full power of Playwright's browser automation to C# and .NET applications. It supports proxy configuration at the browser launch level, routing all browser traffic through Hex Proxies for geo-targeted testing, web scraping, and automated data collection. The .NET API mirrors the Node.js Playwright API closely, with C# idioms for async/await and strong typing.

Complete Configuration with Authentication

using Microsoft.Playwright;

var proxyUser = Environment.GetEnvironmentVariable("PROXY_USER");
var proxyPass = Environment.GetEnvironmentVariable("PROXY_PASS");

using var playwright = await Playwright.CreateAsync();
await using var browser = await playwright.Chromium.LaunchAsync(
    new BrowserTypeLaunchOptions
    {
        Proxy = new Proxy
        {
            Server = "http://gate.hexproxies.com:8080",
            Username = proxyUser,
            Password = proxyPass
        },
        Headless = true
    });

var context = await browser.NewContextAsync(
    new BrowserNewContextOptions
    {
        UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
        ViewportSize = new ViewportSize { Width = 1920, Height = 1080 },
        Locale = "en-US",
        TimezoneId = "America/New_York"
    });

var page = await context.NewPageAsync();
page.SetDefaultTimeout(60000);

await page.GotoAsync("https://httpbin.org/ip");
var content = await page.TextContentAsync("body");
Console.WriteLine(content);

Geo-Targeted Browser Automation

Route traffic through specific countries by appending the country code to the proxy username:

await using var browser = await playwright.Chromium.LaunchAsync(
    new BrowserTypeLaunchOptions
    {
        Proxy = new Proxy
        {
            Server = "http://gate.hexproxies.com:8080",
            Username = proxyUser + "-country-de",
            Password = proxyPass
        }
    });

// Browser context with matching German locale
var context = await browser.NewContextAsync(
    new BrowserNewContextOptions
    {
        Locale = "de-DE",
        TimezoneId = "Europe/Berlin"
    });

Multi-Region Testing Pattern

var regions = new[] {
    ("us", "en-US", "America/New_York"),
    ("gb", "en-GB", "Europe/London"),
    ("de", "de-DE", "Europe/Berlin")
};

foreach (var (country, locale, tz) in regions)
{
    await using var browser = await playwright.Chromium.LaunchAsync(
        new BrowserTypeLaunchOptions
        {
            Proxy = new Proxy
            {
                Server = "http://gate.hexproxies.com:8080",
                Username = 
quot;{proxyUser}-country-{country}",
                Password = proxyPass
            }
        });

    var ctx = await browser.NewContextAsync(
        new BrowserNewContextOptions { Locale = locale, TimezoneId = tz });
    var page = await ctx.NewPageAsync();
    await page.GotoAsync("https://example.com/pricing");

    var price = await page.TextContentAsync(".price");
    Console.WriteLine(
quot;[{country}] Price: {price}");
}

Common Pitfalls

Set extended timeouts (60 seconds) for page navigation through residential proxies — the proxy adds 200-500ms latency per request, and JavaScript-heavy pages may need additional time. Match the browser context locale and timezone to the proxy's geographic region for consistent fingerprinting. Anti-bot systems check for mismatches between IP geolocation and browser locale settings.

Integration with NUnit/xUnit

Playwright for .NET integrates cleanly with .NET test frameworks. Create a base test class that configures the proxy browser, and inherit from it in your regional test classes.