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

TimeoutError: locator.click: Timeout 30000ms exceeded.

Pe scurt

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 de element 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

Greșit
JavaScript
await page.getByRole('button', { name: 'Detalii Laptop UltraBook 14' }).click();
Corect
JavaScript
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ă

Greșit
JavaScript
await page.getByRole('button', { name: 'Adauga in cos' }).click();
Corect
JavaScript
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

Greșit
JavaScript
await page.getByRole('menuitem', { name: 'Deconectare' }).click();
Corect
JavaScript
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ă tu

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.

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

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

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