# net::ERR_CONNECTION_REFUSED (Playwright)

Source: https://www.observeone.com/community/errors/playwright/net-err-connection-refused

[ObserveOne](/)[Features](/#features)[Pricing](/#pricing)[Blog](/blog)[CLI](/cli)[Docs](/docs)

[Sign in](https://app.observeone.com/auth?tab=signin)[Start Free](https://app.observeone.com/auth?tab=signup)

[Error Dictionary](/community/errors)/[Playwright](/community/errors/playwright)/net-err-connection-refusedcritical

# net::ERR_CONNECTION_REFUSED

The browser could not connect to the target URL. The server is not running, the port is blocked, or the URL is incorrect.

## Common Causes

- 1Development server is not running
- 2Wrong port number in the URL
- 3Server crashed during the test
- 4Firewall blocking the connection
- 5Container or service not yet ready in CI/CD

## How to Fix

### Use webServer config to auto-start your dev server

// playwright.config.ts
export default defineConfig({
 webServer: {
 command: 'npm run dev',
 port: 3000,
 reuseExistingServer: !process.env.CI,
 },
});Playwright will automatically start your dev server before running tests and shut it down after.

### Add a health check retry in CI

// wait-for-server.sh
for i in $(seq 1 30); do
 curl -s http://localhost:3000/health && exit 0
 sleep 1
done
exit 1Wait for the server to be ready before running tests, with a 30-second timeout.

## How ObserveOne Helps

ObserveOne monitors your application uptime 24/7, alerting you immediately when servers become unreachable.

[Start Monitoring Free](https://app.observeone.com/auth?tab=signup)

## Related Errors

[TimeoutError: page.goto: Timeout 30000ms exceededNavigation to the target URL did not complete within the timeout period. The page either failed to respond or took too long to reach the 'load' event.](/community/errors/playwright/navigation-timeout)[Error: page.goto: Page crashed!The browser page crashed during execution. This is typically caused by out-of-memory conditions or browser bugs.](/community/errors/playwright/page-crash)[TimeoutError: Exceeded 30000msThe default action timeout (30 seconds) was exceeded before the operation could complete. This commonly occurs during navigation, element waits, or network-dependent operations.](/community/errors/playwright/timeout-30000ms)[TimeoutError: waiting for selectorPlaywright waited for an element matching the given selector but it did not appear within the timeout. The element may not exist, may be hidden, or may appear under a different selector.](/community/errors/playwright/waiting-for-selector)[Error: strict mode violation: locator resolved to N elementsA locator matched more than one element, but the action requires exactly one. Playwright's strict mode (enabled by default) prevents ambiguous interactions.](/community/errors/playwright/strict-mode-violation)

ObserveOne

Agentic QA and synthetic monitoring built for engineering teams. Plan, generate, and run suites from the web UI. Connect to CI for reliable coverage across critical journeys.

### Product

- [Features](/#features)
- [Pricing](/#pricing)
- [QA Coverage](/qa-coverage)
- [API Monitoring](/api-monitoring)
- [Free Website Check](/free-website-check)

### Developers

- [CLI](/cli)
- [Docs](/docs)
- [For Agents](/agents)
- [Self-host (oo-workers)](/workers)
- [Status Pages](/status)
- [Netlify Extension](https://app.netlify.com/extensions/mzs1lgc3-observeone)

### Resources

- [Blog](/blog)
- [Bug Book](/bug-book)
- [Guides](/community/guides)
- [Tools](/community/tools)
- [Error Dictionary](/community/errors)

### Compare

- [Tool Comparisons](/compare)
- [Tool Alternatives](/alternatives)
- [Best by Category](/best)
- [Search](/search)

© 2026 ObserveOne. All rights reserved.

[About](/about)[Privacy Policy](/privacy)[Terms of Service](/terms)[Affiliates](/affiliates)[Become an Affiliate](/affiliate-terms)
