Configure proxy settings for Puppeteer tests

Set up a Local Testing connection for Puppeteer tests behind proxies on BrowserStack Automate. Test websites on 3000+ real browsers and devices.

If you have correctly set up Local Testing but are still unable to load your local/internally-hosted website/assets on BrowserStack, then you might be behind a proxy.

You can use Local Testing to test websites hosted behind proxies, on our remote browsers and devices. The setup will vary based on the proxy implementation in your network. Currently, we only support Local Testing through the following proxies:

1. Proxy with no authentication or HTTP Basic Authentication.
2. MITM proxy with no authentication or HTTP Basic Authentication.
3. PAC (Proxy Auto-Configuration) with no authentication.

Proxy

Proxies are commonly set up for office networks, remote servers, and sometimes on local machines. Contact your network/IT team to obtain the ‘Proxy Host’ and ‘Proxy Port’ to setup Local Testing for this implementation.

Once you obtain the Host and Port, you can establish a Local Testing connection using one of following ways:

browserStackLocalOptions:
  proxyHost: your-proxy-host
  proxyPort: your-proxy-port
  proxyUser: your-proxy-username
  proxyPass: your-proxy-password

const BS_LOCAL_ARGS = {
    'key': process.env.BROWSERSTACK_ACCESS_KEY || 'YOUR_ACCESS_KEY',
    'proxyHost': 'your-proxy-host',
    'proxyPort': 'your-proxy-port',
    'proxyUser': 'your-proxy-username',
    'proxyPass': 'your-proxy-password'
};
bsLocal.start(BS_LOCAL_ARGS, testFn);  // testFn is the actual function that contains the test

./BrowserStackLocal --key YOUR_ACCESS_KEY --proxy-host <proxy_host> --proxy-port <proxy_port>

./BrowserStackLocal --key YOUR_ACCESS_KEY --proxy-host <proxy_host> --proxy-port <proxy_port> --proxy-user <proxy_user> --proxy-pass <proxy_pass>

BrowserStackLocal.exe --key YOUR_ACCESS_KEY --proxy-host <proxy_host> --proxy-port <proxy_port>

BrowserStackLocal.exe --key YOUR_ACCESS_KEY --proxy-host <proxy_host> --proxy-port <proxy_port> --proxy-user <proxy_user> --proxy-pass <proxy_pass>