Error: page.goto: net::ERR_CONNECTION_REFUSED at http://localhost:3000/
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
await page.goto('http://localhost:5173/login');await page.goto('/login'); // baseURL: http://localhost:3000Cu baseURL în config, testele nu depind de port; îl schimbi într-un singur loc.
2Aplicația nu e pornită înainte de teste
// playwright.config.js
export default defineConfig({
use: { baseURL: 'http://localhost:3000' },
});// 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
webServer: { command: 'npm run build && npm run start', url: 'http://localhost:3000' }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ă 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.
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.
Reparația
import { test, expect } from '@playwright/test';
test('pagina de login se deschide', async ({ page }) => {
await page.goto('/login');
await expect(page.getByRole('heading', { name: 'Autentificare' })).toBeVisible();
console.log(page.url());
});De ce merge
Adresa din test trimitea browserul la portul 5173, unde nu rulează aplicația; într-un proiect real, conexiunea e refuzată (ERR_CONNECTION_REFUSED), iar aici pagina rămânea goală. Cu page.goto('/login'), Playwright completează adresa cu baseURL, deci ajunge la http://localhost:3000/login.
Avantajul e că portul și domeniul stau într-un singur loc, în config: dacă aplicația se mută pe alt port sau testele rulează pe staging, schimbi doar baseURL, nu fiecare test.
Alte forme ale mesajului
Error: page.goto: net::ERR_CONNECTION_REFUSED at http://localhost:5173/Error: page.goto: NS_ERROR_CONNECTION_REFUSEDError: 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ă
webServercu comanda de pornire șiurl-ul de verificare; în CI,reuseExistingServer: false. - Verifică portul real al aplicației în consola serverului de dezvoltare.
- Ai câte un
baseURLdiferit 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
Error: page.goto: Protocol error (Page.navigate): Cannot navigate to invalid URL Adresa dată lui page.goto() nu e un URL valid, de obicei pentru că lipsește protocolul: localhost:3000 în loc de http://localhost:3000, sau o cale relativă fără baseURL setat. Scrie adresa completă, cu http://, ori setează baseURL în config și folosește căi care încep cu /. Error: apiRequestContext.get: getaddrinfo ENOTFOUND api.shoprapid.ro Cererea API din test merge la un domeniu care nu poate fi găsit în DNS: nume scris greșit, un domeniu care nu există în mediul de test sau lipsește baseURL. Verifică adresa, folosește căi relative (request.get('/api/products')) cu baseURL în config, iar pentru alt server setează baseURL pe un request.newContext(). Test timeout of 30000ms exceeded. Testul a depășit timpul maxim (implicit 30 de secunde) pentru că a așteptat ceva ce nu s-a întâmplat: de obicei un element pe care locatorul nu îl găsește. Citește call log-ul de sub mesaj, vezi ce locator aștepta și corectează-l după rolul și textul real din pagină. Î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.
