TimeoutError: locator.click: Timeout 30000ms exceeded.
Click-ul a așteptat 30 de secunde (timeout-ul acțiunii) un element pe care nu l-a putut apăsa: locatorul nu găsește nimic sau elementul e ascuns ori dezactivat. Citește call log-ul: arată locatorul căutat și motivul exact; corectează locatorul sau fă întâi pasul care afișează elementul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare când acțiunea are un timeout propriu: actionTimeout în playwright.config.js (sau test.use), ori { timeout: 30000 } dat direct la click. TimeoutError e tipul erorii, locator.click e metoda care a așteptat, iar Timeout 30000ms exceeded spune cât a așteptat.
Sub mesaj vine Call log, cu pașii încercați:
waiting for getByRole('button', { name: 'Detalii' })fără nimic dedesubt: locatorul nu găsește niciun element;locator resolved to <button ...>urmat deelement is not visible: elementul există, dar e ascuns;element is not enabled: butonul e dezactivat.
La fel apar locator.fill, locator.check, locator.hover cu același mesaj, doar cu alt nume de metodă. Linia marcată cu > în cadrul de cod e locul din test unde s-a blocat.
De ce apare: cauzele frecvente
1Rol greșit: elementul e link, nu buton
await page.getByRole('button', { name: 'Detalii Laptop UltraBook 14' }).click();await page.getByRole('link', { name: 'Detalii Laptop UltraBook 14' }).click();Linkul „Detalii” are rolul link. Cu rolul button locatorul găsește zero elemente și click-ul așteaptă până la timeout.
2Textul din locator diferă de cel din pagină
await page.getByRole('button', { name: 'Adauga in cos' }).click();await page.getByRole('button', { name: 'Adaugă în coș' }).first().click();Numele accesibil se compară cu textul real, cu tot cu diacritice. Fără ele, nu se potrivește nimic.
3Elementul apare doar după o altă acțiune
await page.getByRole('menuitem', { name: 'Deconectare' }).click();await page.getByTestId('user-name').hover();
await page.getByRole('menuitem', { name: 'Deconectare' }).click();Meniul se deschide la hover. Până atunci elementul e ascuns, iar Playwright așteaptă să devină vizibil.
Repară eroarea, direct în pagină
Proiectul are actionTimeout: 10000, iar testul deschide detaliile laptopului pică cu TimeoutError: locator.click: Timeout 10000ms exceeded.. În catalogul ShopRapid, fiecare card are un link „Detalii” cu numele accesibil Detalii <produs>. Rulează testul, citește call log-ul și repară locatorul, ca testul să ajungă pe pagina produsului și să verifice titlul Laptop UltraBook 14.
import { test, expect } from '@playwright/test';
test.use({ actionTimeout: 10000 });
test('deschide detaliile laptopului', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByRole('button', { name: 'Detalii Laptop UltraBook 14' }).click();
await expect(page.getByTestId('product-title')).toHaveText('Laptop UltraBook 14');
});Indiciu
Verifică rolul elementului: un <a href> nu e buton.
Reparația
import { test, expect } from '@playwright/test';
test.use({ actionTimeout: 10000 });
test('deschide detaliile laptopului', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByRole('link', { name: 'Detalii Laptop UltraBook 14' }).click();
await expect(page.getByTestId('product-title')).toHaveText('Laptop UltraBook 14');
});De ce merge
Call log-ul arăta doar waiting for getByRole('button', { name: 'Detalii Laptop UltraBook 14' }), adică niciun element găsit. „Detalii” e un link (<a href>), deci are rolul link. Cu getByRole('link', ...) locatorul găsește exact un element, click-ul deschide pagina produsului, iar toHaveText confirmă titlul.
Diferența de rol e greșeala cea mai des întâlnită la getByRole: arată la fel pe ecran, dar pentru Playwright și pentru cititoarele de ecran e alt tip de element.
Alte forme ale mesajului
TimeoutError: locator.fill: Timeout 30000ms exceeded.TimeoutError: locator.check: Timeout 30000ms exceeded.TimeoutError: locator.hover: Timeout 30000ms exceeded.TimeoutError: page.click: Timeout 30000ms exceeded.
Cum o eviți pe viitor
Scrie locatorii după rol și numele vizibil, verificați în pagină (de exemplu cu inspectorul din npx playwright test --ui sau cu codegen). Când apare eroarea, nu mări timeout-ul: citește call log-ul. Dacă vezi doar waiting for, locatorul e greșit; dacă vezi element is not visible sau not enabled, lipsește un pas al utilizatorului (hover, bifare, completarea unui câmp). Un actionTimeout de 10–15 secunde în config face ca astfel de greșeli să se vadă mai repede.
Întrebări frecvente
De ce uneori apare Test timeout, iar alteori TimeoutError?
Implicit, acțiunile nu au timeout propriu și se opresc la bugetul testului (Test timeout of 30000ms exceeded.). Dacă ai setat actionTimeout sau { timeout } la acțiune, se oprește acțiunea întâi, cu TimeoutError: locator.click: Timeout ...ms exceeded.
Ajută { force: true }?
Doar ascunde problema. force sare peste verificările de vizibilitate și activare, deci testul apasă un element pe care un utilizator real nu l-ar putea apăsa. Repară cauza, nu verificarea.
Erori înrudite
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ă. element is not visible Locatorul a găsit elementul, dar acesta e ascuns (hidden, display: none, într-un meniu închis), iar Playwright nu apasă elemente pe care utilizatorul nu le vede. Fă întâi pasul care îl afișează (hover pe meniu, click pe un tab, deschiderea unui dialog) sau corectează locatorul, dacă a găsit o copie ascunsă. element is not enabled Butonul sau câmpul găsit e dezactivat (atributul disabled), iar Playwright așteaptă să devină activ înainte de click, până la timeout. Fă în test pasul care îl activează (bifează acordul, completează câmpurile obligatorii) sau, dacă testul chiar verifică starea, folosește expect(locator).toBeDisabled(). Î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.
