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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
await expect(locator).toBeVisible() reîncearcă până când elementul există și e vizibil (are dimensiune, nu e hidden, display: none sau visibility: hidden). Limita implicită e expect.timeout, 5000 ms, mult mai mică decât timeout-ul testului.
Rândul Received spune de ce a picat:
<element(s) not found>: locatorul nu găsește nimic (sau elementul apare după 5 secunde);hidden: elementul există, dar e ascuns.
Pentru o operație lentă știută (un raport, un catalog mare, un export), mărește limita doar acolo: toBeVisible({ timeout: 10000 }). Nu pune waitForTimeout înainte: o pauză fixă e prea lungă când aplicația e rapidă și prea scurtă când e lentă.
De ce apare: cauzele frecvente
1Aplicația răspunde mai lent de 5 secunde
await expect(page.getByTestId('product-card').first()).toBeVisible();await expect(page.getByTestId('product-card').first()).toBeVisible({ timeout: 10000 });Timeout-ul mai mare se aplică doar aici, unde știi că serverul e lent.
2Elementul e ascuns până la o acțiune
await expect(page.getByRole('menuitem', { name: 'Deconectare' })).toBeVisible();await page.getByTestId('user-name').hover();
await expect(page.getByRole('menuitem', { name: 'Deconectare' })).toBeVisible();Meniul utilizatorului se deschide la hover.
3Locatorul nu se potrivește cu nimic
await expect(page.locator('.toast-success')).toBeVisible();await expect(page.getByRole('status')).toBeVisible();Clasa nu există pe pagină, deci Received: <element(s) not found>.
Repară eroarea, direct în pagină
În această versiune a ShopRapid, produsele din catalog vin de la server după aproximativ 6 secunde. Testul catalogul se încarcă pică cu expect(locator).toBeVisible() failed. Repară-l fără pauze fixe: aserțiunea pe primul card trebuie să aștepte cât e nevoie (de exemplu 10 secunde), iar restul testelor să păstreze limita implicită. Testul afișează apoi numărul de produse.
import { test, expect } from '@playwright/test';
test('catalogul se încarcă', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card').first()).toBeVisible();
console.log(await page.getByTestId('results-count').textContent());
});Indiciu
Poți da un timeout propriu unei singure aserțiuni.
Reparația
import { test, expect } from '@playwright/test';
test('catalogul se încarcă', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card').first()).toBeVisible({ timeout: 10000 });
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
toBeVisible() reîncerca 5 secunde (limita implicită a aserțiunilor), dar produsele apăreau după aproximativ 6, deci aserțiunea pica deși aplicația funcționa. toBeVisible({ timeout: 10000 }) mărește limita doar pentru această verificare.
Spre deosebire de waitForTimeout(6000), aserțiunea se termină imediat ce cardul apare: dacă serverul răspunde mai repede, testul nu pierde timp. Limita globală rămâne 5 secunde, ca alte probleme să se vadă repede.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toBeVisible()Error: expect(locator).toBeVisible() failed Expected: visible Received: hiddenError: expect(locator).not.toBeVisible() failed
Cum o eviți pe viitor
- Pentru o operație lentă știută, pune
{ timeout }doar pe aserțiunea respectivă sautest.slow()pe test. - Nu mări
expect.timeoutglobal ca să ascunzi o aplicație lentă: toate testele vor pica mai greu. - Verifică în trace dacă elementul apare târziu (aplicație lentă) sau deloc (locator greșit, pas lipsă).
- Evită
waitForTimeout: așteaptă o stare, nu o durată.
Întrebări frecvente
De ce aserțiunea pică după 5 secunde, deși testul are 30?
Aserțiunile au propriul timeout, expect.timeout, implicit 5000 ms. Timeout-ul testului (30000 ms) e bugetul pentru tot testul.
Cum verific că un element NU e vizibil?
Cu await expect(locator).toBeHidden() sau not.toBeVisible(). Ambele așteaptă ca elementul să dispară.
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ă. 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ă. 1 flaky Raportul spune „1 flaky” când un test a picat, apoi a trecut la reîncercare (retries). Cauza tipică: testul citește pagina după o pauză fixă (waitForTimeout) sau cu valori de moment (count(), textContent(), isVisible()). Înlocuiește-le cu aserțiuni care așteaptă: toHaveCount, toHaveText, toBeVisible. Î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.
