How to Set Up Bright Data With Playwright

Streamline your web automation with Bright Data and Playwright. This guide shows you how to configure secure, anonymous proxies that reduce detection risks and keep your tasks running smoothly.

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?

Playwright is a versatile Node.js toolkit for automating popular browsers in one go. Whether you’re scraping data, testing applications, or building seamless automation flows, Playwright’s unified interface and robust features help you get more done in less time—without compromising quality.

Maintain a consistent IP throughout your browser session by using the -session parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. Learn more

New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in Immediate-Access mode

For use-cases related to account management, use a consistent static dedicated IP for each account you are managing. dedicated ISP proxies should be used for this.

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:

npm install playwright

Get Your Bright Data Credentials

Log in to your Bright Data dashboard and note the following details:

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

You’ll need these for proxy authentication.

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

If you get SSL errors working our residential proxies or unlocker set: ignoreHTTPSErrors: True in your JS code. Alternatively - you can setup our certificate on your system or import it into your code. More access information can be found here.

Example Code

Use this example to get started:

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

(async () => {
  // Launch browser with proxy settings
  const browser = await chromium.launch({
    headless: false,  // Set to true for headless mode
    proxy: {
      server: 'http://[HOST]:[PORT]',  // Replace with your proxy host and port
      username: '[USERNAME]',        // Replace with your proxy username
      password: '[PASSWORD]'         // Replace with your proxy password
    }
  });

  const context = await browser.newContext();
  const page = await context.newPage();

  // Test the proxy by visiting an IP verification website
  await page.goto('http://httpbin.org/ip');
  // Capture a screenshot to verify the setup
  await page.screenshot({ path: 'example.png' });

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

With Bright Data integrated into Playwright, your automation is both secure and discreet. Enjoy faster workflows, reduced detection risks, and greater peace of mind as you scrape, test, and automate online tasks.