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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Rândul - element is not visible apare în call log-ul unei acțiuni care a expirat (TimeoutError: locator.click: Timeout ...ms exceeded. sau Test timeout of 30000ms exceeded.). Înainte de click, Playwright verifică actionability: elementul trebuie să fie atașat, vizibil, stabil și activ. Call log-ul arată pașii:
locator resolved to <a role="menuitem" ...>: elementul a fost găsit;waiting for element to be visible, enabled and stable;element is not visible: verificarea de vizibilitate nu trece.
Elementul are dimensiune zero, e hidden / display: none / visibility: hidden, ori e într-un container ascuns: un meniu care se deschide la hover, un tab inactiv, un dialog închis. Playwright reîncearcă până la timeout, în speranța că elementul devine vizibil; dacă nimic din test nu îl afișează, nu va deveni.
De ce apare: cauzele frecvente
1Meniul se deschide doar la hover
await page.getByText('Contul meu').click();await page.getByTestId('user-name').hover();
await page.getByRole('menuitem', { name: 'Contul meu' }).click();Opțiunile meniului sunt ascunse până treci cu mouse-ul peste numele utilizatorului.
2Locatorul găsește o copie ascunsă (de ex. meniul de mobil)
await page.locator('a:has-text("Catalog")').first().click();await page.getByRole('link', { name: 'Catalog', exact: true }).click();getByRole ignoră elementele ascunse, deci alege linkul vizibil; un selector CSS cu .first() poate lua varianta ascunsă.
3Elementul apare după o acțiune care nu s-a făcut
await page.getByRole('button', { name: 'Salvează' }).click();await page.getByRole('button', { name: 'Editează' }).click();
await page.getByRole('button', { name: 'Salvează' }).click();Butonul „Salvează” e ascuns până intri în modul de editare.
Repară eroarea, direct în pagină
Utilizatorul ana@shoprapid.ro e deja logat. Testul deschid contul din meniul utilizatorului pică cu TimeoutError: locator.click: Timeout 5000ms exceeded. și element is not visible în call log. În antetul ShopRapid, butonul Salut, Ana (data-testid="user-name") deschide la hover un meniu cu opțiunile (role="menuitem") Contul meu, Comenzile mele, Deconectare. Repară testul ca să ajungă în pagina contului (/#/cont) cum ar face un utilizator, fără force.
import { test, expect } from '@playwright/test';
test('deschid contul din meniul utilizatorului', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByText('Contul meu').click({ timeout: 5000 });
await expect(page).toHaveURL(/#\/cont$/);
});Indiciu
Treci întâi cu mouse-ul peste numele utilizatorului.
Reparația
import { test, expect } from '@playwright/test';
test('deschid contul din meniul utilizatorului', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByTestId('user-name').hover();
await page.getByRole('menuitem', { name: 'Contul meu' }).click({ timeout: 5000 });
await expect(page).toHaveURL(/#\/cont$/);
});De ce merge
Opțiunea „Contul meu” exista în pagină, dar era ascunsă, pentru că meniul se deschide doar la hover. Playwright a găsit-o (locator resolved to <a role="menuitem">), dar a refuzat să apese un element invizibil și a așteptat până la timeout.
hover() pe user-name deschide meniul, exact ca mouse-ul utilizatorului; acum getByRole('menuitem', { name: 'Contul meu' }) găsește opțiunea vizibilă, iar click-ul duce la /#/cont. Cu force: true testul ar fi trecut și pe o pagină în care meniul nu se deschide deloc.
Alte forme ale mesajului
- waiting for element to be visible, enabled and stable - element is not visibleelement is not visible - waiting...TimeoutError: locator.click: Timeout 30000ms exceeded.
Cum o eviți pe viitor
Scrie testul în pașii utilizatorului: dacă el trebuie să deschidă un meniu, să aleagă un tab sau să deruleze, testul face la fel. Folosește getByRole, care nu găsește elementele ascunse (deci nu te păcălește cu copii invizibile). Nu folosi { force: true } ca să treci peste verificare: testul ar apăsa ceva ce utilizatorul nu poate apăsa și ar ascunde un bug real. Când nu știi de ce e ascuns, deschide trace-ul și uită-te la pagină în momentul acțiunii.
Întrebări frecvente
De ce getByText găsește elementul, dar getByRole nu?
getByText găsește și elementele ascunse, iar getByRole le ignoră implicit (ca un cititor de ecran). Când getByRole nu găsește un element pe care getByText îl găsește, de obicei elementul e ascuns.
Ce înseamnă stable din mesaj?
Că elementul nu se mișcă: Playwright așteaptă să se termine animațiile (poziția să fie aceeași în două cadre la rând) înainte de click.
Erori înrudite
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(). 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. Error: expect(locator).toBeVisible() failed Elementul nu a devenit vizibil în timpul aserțiunii (implicit 5 secunde): nu există, e ascuns sau apare mai târziu. Citește Received: <element(s) not found> înseamnă locator greșit, hidden înseamnă element ascuns; dacă aplicația e doar lentă, mărește timeout-ul doar pentru această aserțiune. Î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.
