Start Free TrialLog In
Integration

Use Shifter with Playwright

Run Chromium, Firefox, and WebKit through Shifter's residential and ISP proxies — credentials inline, no sidecar extension required. First-class proxy support across Node, Python, Java, and .NET.

Quick Start

Install

npm install playwright

Basic Usage

import { chromium } from "playwright";

const browser = await chromium.launch({
  proxy: {
    server: "http://p.shifter.io:443",
    username: "customer-USERNAME-country-us-sid-123ABC",
    password: "PASSWORD",
  },
});

const page = await browser.newPage();
await page.goto("https://ipinfo.io/json");
console.log(await page.textContent("body"));
// {"ip": "154.16.xxx.xxx", "city": "New York", "country": "US", ...}

await browser.close();

Features

Native proxy support with credentials inline — no sidecar extension or browser tweaking required
Same setup works for Chromium, Firefox, and WebKit on every supported platform
Per-context proxy configuration lets you mix countries inside one browser instance
Identical API across Node, Python, Java, and .NET — same proxy dict in every language
Geo-targeting in 195+ countries via username parameters — country, region, city, ASN
Per-request rotation by default, with `sid` for sticky sessions and `ttl-N` for timed pins of N seconds

Examples

Per-Context Geo-Targeting (one browser, many regions)

Each browser context can have its own proxy. Spin up a US context, a UK context, and a JP context inside one browser instance — Playwright's killer feature for parallel localized scraping.

import { chromium } from "playwright";

const browser = await chromium.launch();

async function makeContext(country: string, sid: string) {
  return browser.newContext({
    proxy: {
      server: "http://p.shifter.io:443",
      username: `customer-USERNAME-country-${country}-sid-${sid}`,
      password: "PASSWORD",
    },
    userAgent:
      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
  });
}

const [us, uk, jp] = await Promise.all([
  makeContext("us", "us-001"),
  makeContext("uk", "uk-001"),
  makeContext("jp", "jp-001"),
]);

const [usPage, ukPage, jpPage] = await Promise.all([
  us.newPage(),
  uk.newPage(),
  jp.newPage(),
]);

await Promise.all([
  usPage.goto("https://www.example.com"),
  ukPage.goto("https://www.example.co.uk"),
  jpPage.goto("https://www.example.jp"),
]);

console.log({
  us: await usPage.title(),
  uk: await ukPage.title(),
  jp: await jpPage.title(),
});

await browser.close();

Multi-Browser (Chromium / Firefox / WebKit)

Same proxy config across all three engines. Useful for cross-browser scraping or for picking the engine least likely to trigger bot detection on a given target.

import { chromium, firefox, webkit, type BrowserType } from "playwright";

const proxy = {
  server: "http://p.shifter.io:443",
  username: "customer-USERNAME-country-de-city-berlin-sid-456DEF",
  password: "PASSWORD",
};

async function visit(engine: BrowserType, label: string) {
  const browser = await engine.launch({ proxy });
  const page = await browser.newPage();
  await page.goto("https://example.de");
  const title = await page.title();
  await browser.close();
  return { label, title };
}

const results = await Promise.all([
  visit(chromium, "chromium"),
  visit(firefox, "firefox"),
  visit(webkit, "webkit"),
]);

console.log(results);

Playwright Test Suite

Configure Shifter once in playwright.config.ts so every test routes through the proxy. Use environment variables for credentials so you don't commit them to source.

// playwright.config.ts
import { defineConfig } from "@playwright/test";

export default defineConfig({
  testDir: "./tests",
  workers: 4,

  use: {
    proxy: {
      server: "http://p.shifter.io:443",
      username: process.env.SHIFTER_USER!, // e.g. customer-USERNAME-country-us-sid-test
      password: process.env.SHIFTER_PASS!,
    },
    userAgent:
      "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    viewport: { width: 1920, height: 1080 },
    ignoreHTTPSErrors: false,
  },
});

// tests/products.spec.ts
import { test, expect } from "@playwright/test";

test("US homepage renders", async ({ page }) => {
  await page.goto("https://example.com");
  await expect(page.getByRole("heading", { level: 1 })).toBeVisible();
});

test("Product page parses", async ({ page }) => {
  await page.goto("https://example.com/products/123");
  const price = await page.locator(".price").textContent();
  expect(price).toMatch(/^\$\d+/);
});

Python: chromium.launch with Sticky Session

Playwright is identical across languages. Same dict-shaped proxy config in Python — and the rest of the API mirrors the Node version.

# pip install playwright
# playwright install chromium

import asyncio
import secrets
from playwright.async_api import async_playwright

async def main():
    sid = secrets.token_hex(4)

    async with async_playwright() as p:
        browser = await p.chromium.launch(
            proxy={
                "server": "http://p.shifter.io:443",
                "username": f"customer-USERNAME-country-fr-city-paris-sid-{sid}-ttl-300",
                "password": "PASSWORD",
            }
        )

        context = await browser.new_context(
            user_agent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
        )

        page = await context.new_page()

        # Multi-step flow — same residential IP across every navigation.
        await page.goto("https://example.fr/login", wait_until="networkidle")
        await page.fill("#email", "user@example.com")
        await page.fill("#password", "secret")
        await page.click("button[type=submit]")
        await page.wait_for_url("**/dashboard")

        rows = await page.locator(".order-row").all_text_contents()
        print(f"Found {len(rows)} orders")

        await browser.close()

asyncio.run(main())
FAQ

Frequently asked FAQ questions

Common questions about using Shifter with Playwright.

Pass a `proxy` field on the browser launch options with `server`, `username`, and `password`. Same shape across Chromium, Firefox, and WebKit. Credentials are passed inline — no extension required, and it works in headless mode out of the box.
Get started

Start Using Shifter with Playwright

Drive Chromium, Firefox, and WebKit through Shifter's 205M+ residential and ISP proxies — credentials inline, no extensions required. Works across Node, Python, Java, and .NET.

Try Shifter for FreeSet up in minutes. Cancel anytime.