Error: page.evaluate: TypeError: Failed to fetch
O cerere fetch făcută din pagină nu a primit niciun răspuns: rețeaua a refuzat-o, serverul nu răspunde, a fost blocată de CORS sau un page.route(...).abort() din test a oprit-o. Verifică întâi rutele din test (un abort prea larg), apoi adresa și serverul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
TypeError: Failed to fetch e mesajul browserului (Chrome) când fetch nu primește deloc un răspuns HTTP. Un răspuns 404 sau 500 nu dă eroarea asta; ea înseamnă că cererea nu s-a terminat: conexiune refuzată, domeniu inexistent, cerere blocată de CORS sau de un content blocker, ori anulată. În Playwright o vezi ca Error: page.evaluate: TypeError: Failed to fetch când apelezi fetch din page.evaluate, sau în pageerror / consolă când aplicația face cererea.
În teste, o cauză des întâlnită e chiar testul: page.route('/api/', route => route.abort()), scris pentru a simula lipsa conexiunii la un singur endpoint, blochează toate cererile API. Altă cauză: adresa absolută cu alt port sau alt domeniu decât aplicația (CORS). Firefox și Safari dau alte mesaje (NetworkError when attempting to fetch resource., Load failed).
De ce apare: cauzele frecvente
1route.abort() pe un tipar prea larg
await page.route('**/api/**', (route) => route.abort());await page.route('**/api/newsletter', (route) => route.abort());Abort-ul trebuie să lovească doar cererea pe care o simulezi. Tiparul larg blochează și restul API-ului.
2Adresă cu alt port decât aplicația
await page.evaluate(() => fetch('http://localhost:4000/api/health'));await page.evaluate(() => fetch('/api/health'));Pe alt port nu răspunde nimeni (sau CORS blochează răspunsul). O adresă relativă merge la serverul paginii.
3Ruta rămasă din alt pas
await page.route('**/api/products', (r) => r.abort());
// ... verifici mesajul de eroare
await page.reload();await page.route('**/api/products', (r) => r.abort());
// ... verifici mesajul de eroare
await page.unroute('**/api/products');
await page.reload();Rutele rămân active până la finalul testului. unroute le scoate când nu mai ai nevoie de ele.
Repară eroarea, direct în pagină
Testul serverul răspunde din pagină pică cu TypeError: Failed to fetch. La începutul testului a rămas o rută copiată dintr-un test de newsletter, care trebuia să blocheze doar /api/newsletter, dar blochează tot API-ul. Repară ruta (păstrează blocarea newsletter-ului), ca fetch('/api/health') din pagină să răspundă, apoi afișează codul de stare.
import { test, expect } from '@playwright/test';
test('serverul răspunde din pagină', async ({ page }) => {
await page.route('**/api/**', (route) => route.abort());
await page.goto('/');
const status = await page.evaluate(() => fetch('/api/health').then((r) => r.status));
console.log(status);
});Indiciu
Tiparul rutei se potrivește cu mai multe adrese decât vrei.
Reparația
import { test, expect } from '@playwright/test';
test('serverul răspunde din pagină', async ({ page }) => {
await page.route('**/api/newsletter', (route) => route.abort());
await page.goto('/');
const status = await page.evaluate(() => fetch('/api/health').then((r) => r.status));
console.log(status);
});De ce merge
/api/ se potrivea cu orice cerere API, inclusiv /api/health, iar route.abort() o anula; browserul raporta Failed to fetch, fiindcă nu primea niciun răspuns. Cu tiparul **/api/newsletter, doar abonarea e blocată, cererea de sănătate ajunge la server și întoarce 200. Rutele rămân active tot testul, deci un tipar prea larg afectează și cererile de mai târziu.
Alte forme ale mesajului
TypeError: Failed to fetchTypeError: NetworkError when attempting to fetch resource.TypeError: Load failedError: page.evaluate: TypeError: Failed to fetch
Cum o eviți pe viitor
- Scrie tipare de rute cât mai exacte (
/api/newsletter, nu/api/**). - Scoate rutele temporare cu
page.unroutecând pasul s-a terminat. - Folosește adrese relative (cu
baseURL) pentru cererile din pagină. - Pentru teste de API, folosește fixture-ul
request, nufetchdinpage.evaluate: are mesaje mai clare și nu depinde de CORS.
Întrebări frecvente
Un 404 dă și el Failed to fetch?
Nu. Un 404 e un răspuns: fetch se termină normal, cu response.ok === false. Failed to fetch apare doar când nu există niciun răspuns.
Cum simulez corect lipsa conexiunii?
Cu route.abort() doar pe cererea vizată, sau cu context.setOffline(true) pentru tot browserul, apoi verifici mesajul afișat de aplicație.
Erori înrudite
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ă. Error: route.continue: Route is already handled! Același request a fost rezolvat de două ori în handler-ul lui page.route: de exemplu fulfill() și apoi continue(). Fiecare cerere primește un singur răspuns; pune return după fulfill sau folosește if / else, ca pe fiecare drum să se apeleze exact o metodă. 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(). Î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.
