...
Eroare Testare automată · Timeout-uri: testul a așteptat ceva ce nu s-a întâmplat

TimeoutError: page.waitForSelector: Timeout 30000ms exceeded.

Pe scurt

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)

Greșit
JavaScript
await page.waitForSelector('[data-test=product-card]');
Corect
JavaScript
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

Greșit
JavaScript
await page.waitForSelector('#mesaj-salvat');
Corect
JavaScript
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

Greșit
JavaScript
await page.locator('.btn-primary-submit').waitFor();
Corect
JavaScript
await page.getByRole('button', { name: 'Trimite' }).waitFor();

Clasele CSS se schimbă des la redesign. Rolul și textul butonului rămân.

Repară tu

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.

Codul care dă eroarea
JavaScript
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.

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 waitForSelector urmat 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

← Toate erorile Testare automată

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.