# Playwright

Source: https://docs.evomi.com/proxy-instructions/integration-guides/playwright/

This guide explains how to use Evomi proxies with Playwright, a modern browser automation library with built-in proxy authentication support. Examples are provided for both JavaScript/TypeScript and Python.

## Prerequisites

- Node.js 18+ (for JavaScript) or Python 3.8+ (for Python)
- Playwright installed in your project
- Your Evomi proxy credentials (username and password)

## Installation

**JavaScript:**

```bash
npm install playwright
npx playwright install
```

**Python:**

```bash
pip install playwright
playwright install
```

## Configuration

Playwright natively supports proxy authentication -- no extensions or workarounds needed. You can configure the proxy at the browser level (applies to all pages) or at the context level (different proxies per context).

### Browser-Level Proxy

This applies the proxy to all pages opened by this browser instance.

**JavaScript:**

```javascript
const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({
    proxy: {
      server: 'http://rp.evomi.com:1000',
      username: 'your_username',
      password: 'your_password_session-anychars_mode-speed'
    }
  });

  const page = await browser.newPage();
  await page.goto('https://ip.evomi.com/s');
  console.log(await page.textContent('body'));

  await browser.close();
})();
```

**Python:**

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://rp.evomi.com:1000",
        "username": "your_username",
        "password": "your_password_session-anychars_mode-speed"
    })

    page = browser.new_page()
    page.goto("https://ip.evomi.com/s")
    print(page.text_content("body"))

    browser.close()
```

### Context-Level Proxy

Use different proxies for different browser contexts within the same browser instance. This is useful for multi-region testing or rotating proxies.

**JavaScript:**

```javascript
const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({
    proxy: { server: 'per-context' }
  });

  const usContext = await browser.newContext({
    proxy: {
      server: 'http://rp.evomi.com:1000',
      username: 'your_username',
      password: 'your_password_session-anychars_country-us'
    }
  });

  const dePage = await (await browser.newContext({
    proxy: {
      server: 'http://rp.evomi.com:1000',
      username: 'your_username',
      password: 'your_password_session-anychars_country-de'
    }
  })).newPage();

  const usPage = await usContext.newPage();
  await usPage.goto('https://ip.evomi.com/s');
  console.log('US proxy IP:', await usPage.textContent('body'));

  await dePage.goto('https://ip.evomi.com/s');
  console.log('DE proxy IP:', await dePage.textContent('body'));

  await browser.close();
})();
```

On Chromium on Windows, you must pass `proxy: { server: 'per-context' }` at the browser level to enable context-specific proxies. On other platforms and browsers, this is not required.

### Using SOCKS5

Replace the server URL to use the SOCKS5 endpoint:

```javascript
proxy: {
  server: 'socks5://rp.evomi.com:1002',
  username: 'your_username',
  password: 'your_password_session-anychars_mode-speed'
}
```

## Evomi Proxy Endpoints

| Proxy Type | HTTP | HTTPS | SOCKS5 |
|---|---|---|---|
| **Residential** | `rp.evomi.com:1000` | `rp.evomi-proxy.com:1001` | `rp.evomi.com:1002` |
| **Mobile** | `mp.evomi.com:3000` | `mp.evomi-proxy.com:3001` | `mp.evomi.com:3002` |
| **Datacenter** | `dcp.evomi.com:2000` | `dcp.evomi-proxy.com:2001` | `dcp.evomi.com:2002` |

HTTPS endpoints use the `evomi-proxy.com` domain — that is the hostname our TLS certificate covers, and it reaches the same servers. A client that verifies certificates will reject the `evomi.com` form on the HTTPS port.

## Running the Script

**JavaScript:**

```bash
node proxy_test.js
```

**Python:**

```bash
python proxy_test.py
```

The script will print the proxy IP to the console.

## Tips and Troubleshooting

- **Credentials**: Double-check your username and password. The password format is `your_password_session-anychars_mode-speed`.
- **Browser choice**: Playwright supports Chromium, Firefox, and WebKit. All three support proxy configuration. Replace `chromium` with `firefox` or `webkit` as needed.
- **Headless mode**: Playwright runs headless by default. Add `headless: False` (Python) or `headless: false` (JS) to `launch()` to see the browser window.
- **Timeouts**: For slow proxy connections, increase the navigation timeout: `page.goto(url, { timeout: 60000 })`.
- **Proxy bypass**: To exclude specific hosts from the proxy, add a `bypass` field: `proxy: { server: '...', bypass: 'localhost,127.0.0.1' }`.