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().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
page.waitForSelector(selector) așteaptă ca un element care se potrivește cu selectorul să fie atașat și vizibil (starea implicită visible). Call log-ul waiting for locator('[data-test=product-card]') to be visible arată selectorul folosit.
Dacă eroarea apare, ori selectorul nu se potrivește cu nimic (un atribut scris greșit, o clasă care nu există, un id schimbat), ori elementul există dar e ascuns (hidden, display: none).
Metoda e din API-ul vechi. Documentația Playwright recomandă locatori și aserțiuni web-first: await expect(page.getByTestId('product-card')).toHaveCount(8) așteaptă la fel, dar verifică și rezultatul și îți arată la eșec ce a găsit. Varianta pe locator, locator.waitFor(), dă același tip de mesaj: TimeoutError: locator.waitFor: Timeout ...ms exceeded.
De ce apare: cauzele frecvente
1Atribut scris greșit (data-test în loc de data-testid)
await page.waitForSelector('[data-test=product-card]');await expect(page.getByTestId('product-card')).toHaveCount(8);Cardurile au data-testid, nu data-test. Selectorul nu se potrivește cu nimic și așteptarea expiră.
2Elementul există, dar e ascuns
await page.waitForSelector('#mesaj-salvat');await page.waitForSelector('#mesaj-salvat', { state: 'attached' });Implicit se așteaptă starea visible. Dacă vrei doar să existe în DOM, cere state: 'attached'; dacă trebuie să fie vizibil, caută de ce rămâne ascuns.
3Clasa CSS s-a schimbat după un refactor
await page.locator('.btn-primary-submit').waitFor();await page.getByRole('button', { name: 'Trimite' }).waitFor();Clasele CSS se schimbă des la redesign. Rolul și textul butonului rămân.
Repară eroarea, direct în pagină
Testul catalogul afișează produsele pică cu TimeoutError: page.waitForSelector: Timeout 10000ms exceeded.. În catalogul ShopRapid, fiecare produs e un <article data-testid="product-card">, iar catalogul are 8 produse. Înlocuiește waitForSelector cu o aserțiune care așteaptă cele 8 carduri, apoi lasă testul să afișeze textul din results-count.
import { test, expect } from '@playwright/test';
test('catalogul afișează produsele', async ({ page }) => {
await page.goto('/#/catalog');
await page.waitForSelector('[data-test=product-card]', { timeout: 10000 });
console.log(await page.getByTestId('results-count').textContent());
});Indiciu
Atributul cardurilor e data-testid, iar pentru el există getByTestId.
Reparația
import { test, expect } from '@playwright/test';
test('catalogul afișează produsele', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
Selectorul [data-test=product-card] caută un atribut care nu există pe pagină, deci waitForSelector a așteptat degeaba. Cardurile au data-testid="product-card", iar page.getByTestId('product-card') le găsește direct.
await expect(...).toHaveCount(8) așteaptă până se încarcă lista (aplicația cere produsele de la API) și verifică și numărul lor. Abia după aceea citirea lui results-count e sigură: 8 produse.
Alte forme ale mesajului
TimeoutError: locator.waitFor: Timeout 30000ms exceeded.Error: page.waitForSelector: Test timeout of 30000ms exceeded.TimeoutError: page.waitForSelector: Timeout 10000ms exceeded.
Cum o eviți pe viitor
- Folosește locatori (
getByRole,getByLabel,getByTestId) în loc de selectori CSS scriși de mână. - În loc de
waitForSelectorurmat de o citire, scrie direct aserțiunea care așteaptă:toBeVisible,toHaveCount,toHaveText. - Verifică selectorul în consola browserului (
document.querySelectorAll('...')) sau în inspectorul Playwright înainte să-l pui în test. - Dacă proiectul folosește alt atribut de test, setează
testIdAttributeîn config.
Întrebări frecvente
E greșit să folosesc waitForSelector?
Nu e greșit, dar e o metodă veche. Aserțiunile pe locatori fac aceeași așteptare și îți spun la eșec ce au găsit (Received), deci sunt mai ușor de depanat.
Proiectul meu folosește data-test, nu data-testid. Ce fac?
Setează use: { testIdAttribute: 'data-test' } în playwright.config.js, apoi folosește getByTestId('product-card') normal.
Erori înrudite
Received: <element(s) not found> Aserțiunea nu a găsit niciun element pentru locatorul dat, deci selectorul e greșit sau elementul nu există pe pagina curentă. Verifică în pagină cum poate fi găsit elementul (rol, text, data-testid) și scrie locatorul după asta, nu după un id sau o clasă presupusă. Error: expect(locator).toHaveCount(expected) failed Locatorul a găsit alt număr de elemente decât ai cerut. Ori locatorul e prea larg (prinde și alte elemente cu același text) sau prea îngust, ori aplicația chiar afișează alt număr. Compară Expected cu Received și numără elementele care te interesează, de exemplu cardurile de produs după data-testid. 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.
