TimeoutError: page.goto: Timeout 30000ms exceeded.
page.goto a așteptat 30 de secunde evenimentul de încărcare cerut (load sau networkidle) și nu l-a primit. Cauza tipică e waitUntil: 'networkidle' pe o pagină care face mereu cereri, sau un server foarte lent. Lasă goto cu valorile implicite și așteaptă cu expect elementul de care ai nevoie.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
page.goto(url) deschide adresa și așteaptă un eveniment de încărcare: implicit load (pagina și resursele ei s-au încărcat), sau ce ai cerut cu waitUntil (domcontentloaded, load, networkidle, commit). Mesajul spune că evenimentul nu a venit în timpul permis de timeout (sau de navigationTimeout din config). Sub mesaj, Call log arată navigating to "...", waiting until "networkidle": acolo vezi ce a așteptat.
Cauze obișnuite: networkidle (nicio cerere 500 ms) pe o aplicație cu polling, analytics sau websockets, care nu ajunge niciodată „liniștită”; un server de test pornit greu sau blocat; o resursă externă (font, script de reclame) care nu răspunde și ține load pe loc. Documentația Playwright descurajează networkidle în teste: e mai sigur să aștepți ce contează pentru test (o listă, un titlu) cu expect, care reîncearcă singur.
De ce apare: cauzele frecvente
1networkidle pe o pagină care nu se liniștește
await page.goto('/#/catalog', { waitUntil: 'networkidle' });await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);Polling-ul sau analytics-ul fac cereri tot timpul, deci networkidle nu vine. expect așteaptă exact elementele de care are nevoie testul.
2Resursă externă care blochează load
await page.goto('/'); // un script de chat extern nu răspundeawait page.route('**/widget-chat.js', (r) => r.abort());
await page.goto('/');load așteaptă toate scripturile. Blocarea resursei externe (inutile în test) lasă pagina să termine încărcarea.
3Serverul de test încă pornește
// testele pornesc înainte ca serverul să asculte
await page.goto('/');// playwright.config.js
webServer: { command: 'npm run start', url: 'http://localhost:3000', reuseExistingServer: true }Cu webServer, Playwright așteaptă ca serverul să răspundă înainte să ruleze testele.
Repară eroarea, direct în pagină
Testul catalogul afișează toate produsele folosește waitUntil: 'networkidle', care pe aplicația reală dă page.goto: Timeout 30000ms exceeded, iar în laborator nu așteaptă lista: testul numără cardurile prea devreme. Scoate networkidle și așteaptă cu expect cele 8 carduri product-card, apoi afișează numărul lor.
import { test, expect } from '@playwright/test';
test('catalogul afișează toate produsele', async ({ page }) => {
await page.goto('/#/catalog', { waitUntil: 'networkidle' });
const numar = await page.getByTestId('product-card').count();
console.log(numar);
expect(numar).toBe(8);
});Indiciu
Așteaptă elementele de care are nevoie testul, nu „liniștea” rețelei.
Reparația
import { test, expect } from '@playwright/test';
test('catalogul afișează toate produsele', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
const numar = await page.getByTestId('product-card').count();
console.log(numar);
expect(numar).toBe(8);
});De ce merge
networkidle așteaptă ca rețeaua să stea 500 ms fără cereri, ceea ce pe o aplicație cu polling nu se întâmplă niciodată, deci goto depășește timpul. Nici nu garantează că datele sunt afișate. expect(...).toHaveCount(8) reîncearcă până apar cele 8 carduri, apoi count() citește valoarea corectă.
Alte forme ale mesajului
TimeoutError: page.goto: Timeout 30000ms exceeded. Call log: - navigating to "http://localhost:3000/", waiting until "networkidle"TimeoutError: page.goto: Timeout 60000ms exceeded.Error: page.goto: Test timeout of 30000ms exceeded.TimeoutError: page.reload: Timeout 30000ms exceeded.
Cum o eviți pe viitor
- Nu folosi
waitUntil: 'networkidle'ca să „aștepți să se încarce tot”; dupăgoto, verifică cuexpectelementul de care ai nevoie. - Blochează în teste resursele externe inutile (reclame, chat, analytics) cu
page.route. - Pornește aplicația din
webServerîn config, ca testele să înceapă doar când serverul răspunde. - Dacă serverul e lent doar în CI, mărește
navigationTimeoutacolo, nu în toate testele.
Întrebări frecvente
Care e diferența dintre load și domcontentloaded?
domcontentloaded vine după ce HTML-ul a fost citit, fără să aștepte imaginile și scripturile asincrone. load vine după ce s-au încărcat și resursele. Pentru o aplicație care își aduce datele prin API, niciunul nu garantează că lista e afișată: de aceea verifici lista cu expect.
De ce merge local și pică în CI?
În CI rețeaua și mașina sunt mai lente, iar uneori resursele externe sunt blocate de firewall. O pagină care abia încăpea în 30 de secunde local depășește timpul acolo.
Erori înrudite
TimeoutError: page.waitForURL: Timeout 30000ms exceeded. Testul a așteptat ca adresa paginii să ajungă la un anumit URL, dar navigarea nu a avut loc sau a dus la altă adresă. Verifică în call log tiparul așteptat (de ex. "**/cont"), compară-l cu adresa reală din page.url() și corectează tiparul sau pasul care trebuia să navigheze. 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ă. 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.
