How to Set Up Bright Data With Playwright

Expand to get your Bright Data Proxy Access Information

​

Your proxy access information

Bright Data proxies are grouped in “Proxy zones”. Each zone holds the configuration for the proxies it holds.To get access to the proxy zone:

1. Login to Bright Data control panel
2. Select the proxy zone or setup a new one
3. Click on the new zone name, and select the Overview tab.
4. In the overview tab, under Access details you can find the proxy access details, and copy them to clipboard on click.
5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
6. Click on the copy icons to copy the text to your clipboard and paste in your tool’s proxy configuration.

​

Access Details Section Example

​

Residential proxy access

To access Bright Data’s Residential Proxies you will need to either get verified by our compliance team, or install a certificate. Read more…

​

Targeting search engines?

If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (SERP) proxy API. Use Bright Data SERP API to target search engines. Click here to read more about Bright Data SERP proxy API.

​

Correct setup of proxy test to avoid “PROXY ERROR”

In many tools you will see a “test proxy” function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy. To correctly test your proxy you should target those search queries to: https://geo.brdtest.com/welcome.txt .Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show proxy error although your proxy is perfectly fine.If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).

​

What is Playwright?

​

How to Integrate Bright Data With Playwright

​

Prerequisites

1. Node.js: Download and install the latest version from nodejs.org.
2. Playwright Package: Add Playwright to your project:
3. Bright Data Account: You must have an active Bright Data account with at least one enabled proxy zone.
   For browser automation use cases, ISP or Data Center proxies are recommended for better stability.
4. Proxy Access Permissions: Ensure your IP is allowlisted in the Bright Data dashboard (if IP whitelisting is enabled) and that your proxy zone is active.
5. Supported Operating System: Playwright is supported on the following operating systems:
   • macOS
   • Linux
   • Windows
   Make sure your system meets Playwright’s browser runtime requirements.
6. Basic JavaScript Knowledge: Familiarity with JavaScript, Node.js, and async/await syntax is recommended to correctly configure and manage Playwright scripts.
7. Network Stability: A stable internet connection is required to download browser binaries and maintain proxy connections during automation tasks.

npm install playwright

​

Get Your Bright Data Credentials

• Host: http://brd.superproxy.io/
• Port: 33335
• Username: Enter your Bright Data username.
• Password: Enter your Bright Data password.

​

Configure Playwright to Use Bright Data

1. Set the Proxy Server: Include your Bright Data host and port in the browser launch options. Use the format host:port.
2. Add Authentication: Provide your Bright Data username and password to ensure secure access.

​

Ignoring SSL Errors

​

Example Code

import { chromium } from 'playwright';

// Bright Data proxy configuration
const BRIGHTDATA_HOST = process.env.BRIGHTDATA_HOST || 'brd.superproxy.io';
const BRIGHTDATA_PORT = process.env.BRIGHTDATA_PORT || '33335';
const BRIGHTDATA_USERNAME = process.env.BRIGHTDATA_USERNAME;
const BRIGHTDATA_PASSWORD = process.env.BRIGHTDATA_PASSWORD;

// Optional: use session to keep the same IP
const SESSION_ID = 'session_1';

(async () => {
  const browser = await chromium.launch({
    headless: true, // set to false for debugging
    proxy: {
      server: `http://${BRIGHTDATA_HOST}:${BRIGHTDATA_PORT}`,
      username: `${BRIGHTDATA_USERNAME}-session-${SESSION_ID}`,
      password: BRIGHTDATA_PASSWORD,
    },
  });

  const context = await browser.newContext({
    ignoreHTTPSErrors: true, // prevents SSL issues with residential / Unlocker proxies
  });

  const page = await context.newPage();

  // Verify proxy connection
  await page.goto('https://lumtest.com/myip.json', {
    waitUntil: 'networkidle',
    timeout: 60000,
  });

  const ipInfo = await page.textContent('pre');
  console.log('Proxy IP info:', ipInfo);

  // Navigate to target website
  await page.goto('https://example.com', {
    waitUntil: 'domcontentloaded',
  });

  console.log('Page title:', await page.title());

  // Optional screenshot for validation
  await page.screenshot({ path: 'playwright-brightdata.png' });

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