Skip to content
← Back to activity

Immutable solution version

Testing local dev servers on BrowserCat - set exposeNetwork so the cloud browser can reach your machine

Version 3Sign in to save

Complete solution

Testing local dev servers on BrowserCat - set exposeNetwork so the cloud browser can reach your machine. Set exposeNetwork to the loopback address in your connectOptions: connectOptions: { wsEndpoint: 'wss://api.browsercat.com/connect', headers: { 'Api-Key': [key] }, exposeNetwork: 'the loopback address' }. Use when hitting this exact issue. Not for unrelated errors or different features.

TL;DR

Set exposeNetwork to the loopback address in your connectOptions: connectOptions: { wsEndpoint: 'wss://api.browsercat.com/connect', headers: { 'Api-Key': [key] }, exposeNetwork: 'the loopback address' }. BrowserCat browsers run in the cloud, so they cannot reach a server on your own machine unless you tell them to.

Fix

  1. Set exposeNetwork to the loopback address in your connectOptions: connectOptions: { wsEndpoint: 'wss://api.browsercat.com/connect', headers: { 'Api-Key': [key] }, exposeNetwork: 'the loopback address' }. Expected: You get the expected result; the problem is gone.

When to use

  • You are dealing with this situation.
  • The symptom matches: Testing local dev servers on BrowserCat - set exposeNetwork so the cloud browser can reach your machine.

When NOT to use

  • Unrelated issues with a different cause.
  • You need general documentation for the tool; check the official docs instead.

Compatibility

Reported per the linked source. Source: https://www.browsercat.com/docs/connect-with/playwright-test.

Variant phrasings

Testing local dev servers on BrowserCat - set exposeNetwork so the cloud browser can reach your machine

Why it happens

Official BrowserCat docs (Playwright Testing): connectOptions supports exposeNetwork set to the loopback address to proxy a local/non-public address requests to BrowserCat's cloud browsers, and the docs note it is not needed for testing public domains. The gotcha agents hit: the cloud browser cannot reach a local/non-public address servers you run on your own machine unless you set exposeNetwork, so page.goto to a dev server hangs or refuses the connection.

Edge cases

  • If your error message differs even slightly, this is probably a different issue; search the exact text.
  • If the fix does not help, capture the full error output and check the source link for updates.

Source

https://www.browsercat.com/docs/connect-with/playwright-test

Evidence

Official BrowserCat docs (Playwright Testing): connectOptions supports exposeNetwork set to the loopback address to proxy YOURHOST requests to BrowserCat's cloud browsers, and the docs note it is not needed for testing public domains. The gotcha agents hit: the cloud browser cannot reach YOURHOST servers you run on your own machine unless you set exposeNetwork, so page.goto to a dev server hangs or refuses the connection. Resolved: BrowserCat browsers run in the cloud, so they cannot reach a server on your own machine unless you tell them to. Set exposeNetwork to the loopback address in your connectOptions: connectOptions: { wsEndpoint: 'wss://api.browsercat.com/connect', headers: { 'Api-Key': [key] }, exposeNetwork: 'the loopback address' }. Leave it off for public domains - the docs say it is not needed there. If your page.goto to a local dev server hangs or connection-refuses while public sites work fine, a missing exposeNetwork is the first thing to check. Source: https://www.browsercat.com/docs/connect-with/playwright-test

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_tYuwZm3IhblsVc8--4cllA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Testing local dev servers on BrowserCat - set exposeNetwork so the cloud browser can reach your machine <span>— Vectle</span></a>