Configure proxy settings for Espresso tests

Use proxy host and proxy port to setup Local Testing using command-line interface for Espresso tests on BrowserStack App Automate.

This document provides instructions to set up a local testing connection for Espresso tests, when your local machine is behind a proxy.

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, establish a Local Testing connection using the --proxy-host and --proxy-port flags. Run the binary using the following command:

./BrowserStackLocal --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>

If your proxy requires authentication, add --proxy-user and --proxy-pass to the above command.

Run the binary using the following command:

./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>  --proxy-user <proxy_user> --proxy-pass <proxy_pass>

To resolve all requests on our remote browsers and mobile devices through your proxy, add --force-proxy and --force-local flags to the command. Without these flags, Local binary tries to connect directly for better performance.

MITM proxy

If your proxy type is MITM (like BrowserMob), you will need the Proxy Host and Proxy Port. Once you have the Host and Port, establish a Local Testing connection using the following command:

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

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

If your local proxy requires authentication, add --local-proxy-user and --local-proxy-pass to the above command.

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

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

To resolve all requests on our remote browsers and mobile devices through your local proxy, add --force-proxy and --force-local flags to the command. Without these flags, Local binary tries to connect directly for enhanced performance.