TimeoutError: page.waitForFunction: Timeout 30000ms exceeded.
Funcția dată lui page.waitForFunction nu a întors niciodată o valoare adevărată în timpul permis. De obicei verifici o variabilă sau un selector care nu există (alt nume, altă formă), ori ai pus opțiunile pe locul argumentului. Verifică în consola browserului expresia exactă și pune opțiunile ca al treilea argument.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
page.waitForFunction(fn, arg, options) rulează funcția fn în pagină, din nou și din nou, până întoarce o valoare adevărată (truthy). Dacă timpul expiră înainte, primești TimeoutError: page.waitForFunction: Timeout 30000ms exceeded.; numărul e timeout-ul folosit (din options.timeout sau din config).
Mesajul nu spune ce a întors funcția, deci cauza o cauți în condiție:
- variabila globală sau atributul verificat are alt nume decât în aplicație;
- condiția nu poate fi adevărată niciodată (aștepți 10 carduri, dar sunt 8);
- ai scris
waitForFunction(fn, { timeout: 5000 }): al doilea argument earg, nu opțiunile, deci timeout-ul tău e ignorat și se aplică cel implicit.
Funcția rulează în browser, deci nu vede variabilele din test; ce îi trebuie primește prin arg. Când aștepți un element sau un text, un locator cu expect e aproape mereu varianta mai simplă.
De ce apare: cauzele frecvente
1Numele variabilei din pagină e altul
await page.waitForFunction(() => window.dateIncarcate === true);await page.waitForFunction(() => window.__dateIncarcate === true);Funcția citește o proprietate care nu există, deci primește mereu undefined. Copiază numele exact din codul aplicației sau verifică-l în consola browserului.
2Opțiunile sunt puse pe locul argumentului
await page.waitForFunction(() => window.gata, { timeout: 5000 });await page.waitForFunction(() => window.gata, null, { timeout: 5000 });Semnătura e (fn, arg, options). Obiectul de pe poziția a doua ajunge ca argument al funcției, iar timeout-ul rămâne cel implicit.
3Condiția nu poate deveni adevărată
await page.waitForFunction(() => document.querySelectorAll('.produs').length >= 10);await expect(page.locator('.produs')).toHaveCount(8);Dacă pagina are 8 produse, condiția >= 10 nu se îndeplinește niciodată. O aserțiune pe locator îți arată și ce a găsit.
Repară eroarea, direct în pagină
Testul așteaptă datele aplicației pică cu TimeoutError: page.waitForFunction: Timeout 5000ms exceeded.. Pagina setează window.__dateIncarcate = true după ce încarcă produsele (aproximativ o secundă). Repară condiția din waitForFunction, păstrând timeout-ul de 5 secunde, apoi afișează numărul de produse din listă.
import { test, expect } from '@playwright/test';
test('așteaptă datele aplicației', async ({ page }) => {
await page.goto('/');
await page.waitForFunction(() => window.dateIncarcate === true, null, { timeout: 5000 });
console.log(await page.locator('.produs').count());
});Indiciu
Compară numele proprietății din test cu cel din scriptul paginii.
Reparația
import { test, expect } from '@playwright/test';
test('așteaptă datele aplicației', async ({ page }) => {
await page.goto('/');
await page.waitForFunction(() => window.__dateIncarcate === true, null, { timeout: 5000 });
console.log(await page.locator('.produs').count());
});De ce merge
Condiția citea window.dateIncarcate, o proprietate care nu există, deci întorcea mereu undefined, iar după 5 secunde waitForFunction a renunțat. Scriptul paginii folosește window.__dateIncarcate. Cu numele corect, condiția devine adevărată după încărcare, iar testul continuă.
Timeout-ul stă pe al treilea argument (null e argumentul funcției). Numărul de produse îl citește apoi un locator obișnuit.
Alte forme ale mesajului
TimeoutError: page.waitForFunction: Timeout 5000ms exceeded.Error: page.waitForFunction: Test timeout of 30000ms exceeded.TimeoutError: frame.waitForFunction: Timeout 30000ms exceeded.
Cum o eviți pe viitor
- Folosește
waitForFunctiondoar pentru stări care nu se văd în DOM (o variabilă globală,document.fonts.ready, o bibliotecă încărcată). - Pentru elemente și texte, folosește
await expect(locator)..., care îți arată și ce a primit. - Scrie mereu
waitForFunction(fn, null, { timeout })când dai opțiuni. - Testează condiția o dată în consola browserului înainte s-o pui în test.
Întrebări frecvente
De ce nu văd ce a întors funcția?
Playwright raportează doar că timpul a expirat. Ca să vezi valoarea, rulează aceeași expresie cu page.evaluate și afișeaz-o cu console.log, sau verifică-o în consola browserului deschis cu --headed / --debug.
Pot folosi variabile din test în funcție?
Nu direct: funcția rulează în pagină. Le trimiți prin al doilea argument: page.waitForFunction(min => window.total >= min, 100).
Erori înrudite
TimeoutError: page.waitForSelector: Timeout 30000ms exceeded. Selectorul CSS dat lui waitForSelector nu a găsit niciun element vizibil în timpul dat: selectorul e greșit (clasă, id sau atribut care nu există) sau elementul rămâne ascuns. Verifică selectorul în pagină și, mai bine, înlocuiește așteptarea cu o aserțiune pe un locator: expect(locator).toHaveCount() sau toBeVisible(). Error: page.evaluate: ReferenceError: id is not defined Funcția dată lui page.evaluate rulează în browser, nu în test, deci nu vede variabilele testului. Transmite valoarea ca al doilea argument: page.evaluate((id) => ..., id). 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ă. Timeout 5000ms exceeded while waiting on the predicate expect.poll a apelat funcția ta din nou și din nou timp de 5 secunde, dar valoarea întoarsă nu a trecut niciodată aserțiunea. Verifică întâi că funcția chiar întoarce valoarea (un return lipsă dă mereu undefined), apoi că operația nu durează mai mult decât timeout-ul. Î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.
