Oxylabs' Proxy Integration with Playwright

• Requirements
• Integrating Datacenter Proxies
• Integrating Residential Proxies

Requirements

Playwright

npm install playwright

Integrating Datacenter Proxies

Getting a List of Proxies

Open the following URL in the browser and enter your credentials. You will see a list of proxies in plain text:

https://proxy.oxylabs.io/all

Using Proxies

If you wish to select any of the provided proxies, you need to save the proxy IP, along with the port, in a variable.

To use all these proxies, first, save these proxies as an array in your code:

let proxies = [
    '127.0.0.1:60000',
    '127.0.0.2:60000',
    '127.0.0.3:60000',
    '127.0.0.4:60000'
  ]

To select one of the proxies randomly, use the following line of code:

var proxy = proxies[Math.floor(Math.random() * proxies.length)];

Create a variable called launchOptions and assign the proxy information to it.

Don't forget to replace USERNAME and PASSWORD with your proxy user credentials.

const launchOptions = {
        proxy: {
            server: proxy,
            username: 'USERNAME',
            password: 'PASSWORD'
        }
    };

After creating the launchOptions variable, create a playwright instance and launch the browser.

const browser = await chromium.launch(launchOptions);

For the complete code sample, see this file.

Integrating Residential Proxies

Random Proxy Using the Proxy API

Proxy information can be supplied as a parameter to the launch method of playwright instance.

Alternatively, create a variable called launchOptions and assign the proxy information to it.

Don't forget to replace USERNAME and PASSWORD with your proxy user credentials.

const launchOptions = {
        proxy: {
            server: 'pr.oxylabs.io:7777',
            username: 'USERNAME',
            password: 'PASSWORD'
        },
        headless: false
    };

The additional benefit of using lauchOptions variable is that other information such as headless can be supplied to the launch method.:

After creating the launchOptions variable, create a playwright instance and launch the browser.

const browser = await chromium.launch(launchOptions);

For the complete code sample, see this file.

Country Specific Proxies

If you wish to use country-specific proxies, all you need to do is change the proxy server.

For example, if you wish to use the proxy for the United States, you can use the following code:

const launchOptions = {
        proxy: {
            server: 'us-pr.oxylabs.io:10001',
            username: 'USERNAME',
            password: 'PASSWORD'
        },
        headless: false
    };

In this example, us-pr.oxylabs.io:10000 is the country specific entry point for the United States.

Another example is gb-pr.oxylabs.io:20000, which is the country specific entry point for United Kingdom.

For a complete list of all entry points, see Country Specific Entry Nodes.