...
Eroare Testare automată · Navigare, rețea și teste de API

Error: page.goto: net::ERR_CONNECTION_REFUSED at http://localhost:3000/

Pe scurt

Browserul n-a găsit niciun server care să răspundă la adresa din page.goto(): aplicația nu e pornită sau rulează pe alt port. Pornește aplicația înainte de teste (sau configurează webServer în playwright.config.js) și folosește baseURL cu căi relative în loc de adrese scrise de mână.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

net::ERR_CONNECTION_REFUSED e eroarea de rețea a browserului: a încercat să se conecteze la localhost:3000, dar pe acel port nu ascultă niciun server, deci conexiunea a fost refuzată. Playwright o raportează la page.goto, cu adresa la care a încercat.

Nu e o problemă a testului în sine, ci a mediului:

  • serverul aplicației nu e pornit (ai uitat npm run dev, sau în CI nu există pasul de pornire);
  • aplicația rulează pe alt port (Vite folosește implicit 5173, Next.js 3000, Angular 4200);
  • serverul încă pornește când încep testele;
  • testul are o adresă veche scrisă de mână.

Soluția stabilă e opțiunea webServer din playwright.config.js: Playwright pornește singur aplicația, așteaptă să răspundă la url, rulează testele și o oprește la final. Cu baseURL, testele folosesc doar căi (page.goto('/login')).

De ce apare: cauzele frecvente

1Adresă scrisă de mână, cu alt port

Greșit
JavaScript
await page.goto('http://localhost:5173/login');
Corect
JavaScript
await page.goto('/login'); // baseURL: http://localhost:3000

Cu baseURL în config, testele nu depind de port; îl schimbi într-un singur loc.

2Aplicația nu e pornită înainte de teste

Greșit
JavaScript
// playwright.config.js
export default defineConfig({
  use: { baseURL: 'http://localhost:3000' },
});
Corect
JavaScript
// playwright.config.js
export default defineConfig({
  use: { baseURL: 'http://localhost:3000' },
  webServer: { command: 'npm run start', url: 'http://localhost:3000', reuseExistingServer: !process.env.CI },
});

webServer pornește aplicația și așteaptă să răspundă înainte de primul test.

3Serverul pornește mai greu decât timeout-ul webServer

Greșit
JavaScript
webServer: { command: 'npm run build && npm run start', url: 'http://localhost:3000' }
Corect
JavaScript
webServer: { command: 'npm run build && npm run start', url: 'http://localhost:3000', timeout: 180000 }

Implicit, Playwright așteaptă serverul 60 de secunde; un build lung are nevoie de mai mult.

Repară tu

Repară eroarea, direct în pagină

Testul pagina de login se deschide are adresa scrisă de mână, http://localhost:5173/login. Pe calculatorul tău ar da page.goto: net::ERR_CONNECTION_REFUSED, pentru că aplicația rulează pe portul 3000; în laborator, pe portul 5173 nu răspunde nicio aplicație, deci pagina rămâne goală și aserțiunea pică. Proiectul are baseURL: 'http://localhost:3000'. Repară navigarea ca testul să deschidă pagina /login a aplicației și să afișeze adresa.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('pagina de login se deschide', async ({ page }) => {
  await page.goto('http://localhost:5173/login');
  await expect(page.getByRole('heading', { name: 'Autentificare' })).toBeVisible();
});
Indiciu

Cu baseURL setat, page.goto primește doar calea.

Alte forme ale mesajului

  • Error: page.goto: net::ERR_CONNECTION_REFUSED at http://localhost:5173/
  • Error: page.goto: NS_ERROR_CONNECTION_REFUSED
  • Error: apiRequestContext.get: connect ECONNREFUSED 127.0.0.1:3000

Cum o eviți pe viitor

  • Pune baseURL în config și folosește doar căi relative în teste.
  • Configurează webServer cu comanda de pornire și url-ul de verificare; în CI, reuseExistingServer: false.
  • Verifică portul real al aplicației în consola serverului de dezvoltare.
  • Ai câte un baseURL diferit pe medii (local, staging) prin variabile de mediu, nu prin adrese în cod.

Întrebări frecvente

Local merge, dar în CI primesc ERR_CONNECTION_REFUSED. De ce?

Local aveai aplicația pornită de mână. În CI nu o pornește nimeni, dacă nu ai webServer în config sau un pas separat în pipeline.

Ce face reuseExistingServer?

Dacă e true și aplicația rulează deja la url, Playwright o folosește pe cea pornită de tine, în loc să pornească alta. În CI se lasă false, ca fiecare rulare să pornească de la zero.

Erori înrudite

← Toate erorile Testare automată

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Testare automată de la zero, cu exerciții la fiecare lecție

Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.