Run Flutter tests behind proxy settings

Set up Local Testing behind a proxy or a MITM proxy so that your Flutter integration tests reach internally hosted servers and assets.

If you have set up Local Testing correctly but your Flutter tests still can’t load internally hosted servers or assets, your network is probably behind a proxy. Pass the proxy details to the Local binary so that traffic between BrowserStack devices and your servers resolves the same way it does on your machine.

BrowserStack supports Local Testing through the following proxy types:

• Proxy with no authentication or HTTP basic authentication.
• MITM proxy with no authentication or HTTP basic authentication.
• PAC with no authentication.

The setup varies with the proxy implementation in your network. Contact your network or IT team to find the proxy settings that apply to you.

Proxy

Proxies are commonly set up for office networks, remote servers, and sometimes on local machines. Contact your network or IT team to obtain the Proxy Host and Proxy Port. After you have them, use the --proxy-host and --proxy-port flags to establish a Local Testing connection:

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

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

MITM proxy

If your proxy type is MITM, such as BrowserMob, you need the Proxy Host and Proxy Port as well. Use the --local-proxy-host and --local-proxy-port flags to establish the connection:

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

To resolve all requests on BrowserStack devices through your local proxy, add the --force-proxy and --force-local flags to the command.

Run your build through the connection

After the Local Testing connection is up, set the local parameter to true in your build REST API request so that the build runs through the tunnel:

Replace the app and testSuite values with the app_url and test_url of the app and test suite you uploaded to BrowserStack.

If your network resolves proxies through a PAC file instead, see Work with PAC files for Flutter tests.