Error: expect(locator).toBeHidden() failed
Elementul a rămas vizibil toate cele 5 secunde de așteptare: indicatorul de încărcare nu a dispărut la timp, fereastra nu s-a închis sau locatorul găsește alt element vizibil. Verifică ce îl ascunde și, dacă e doar lent, mărește timeout-ul doar pentru acea aserțiune.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toBeHidden() trece când elementul nu există în pagină sau există, dar nu e vizibil (display:none, visibility:hidden, atributul hidden). Raportul Expected: hidden, Received: visible și rândul locator resolved to ... din call log arată că elementul a fost găsit și era încă afișat după 5 secunde.
Apare des la indicatorii de încărcare („Se încarcă...”), la mesajele temporare (toast) și la ferestrele modale. Trei întrebări te duc la cauză: durează operația mai mult de 5 secunde (atunci e nevoie de un timeout mai mare, doar acolo)? A făcut testul acțiunea care ascunde elementul (click pe butonul corect, cererea a reușit)? Locatorul e destul de precis, sau prinde și un alt element vizibil cu același text? Dacă raportul arată un element pe care nu-l așteptai la locator resolved to, problema e la locator.
De ce apare: cauzele frecvente
1Operația durează mai mult decât timeout-ul aserțiunii
await page.goto('/#/catalog');
await expect(page.getByTestId('loading')).toBeHidden();await page.goto('/#/catalog');
await expect(page.getByTestId('loading')).toBeHidden({ timeout: 10000 });Implicit expect așteaptă 5 secunde. Dacă încărcarea durează 6, mărești limita doar pentru acest pas, nu pentru toate aserțiunile.
2Testul nu face acțiunea care ascunde elementul
await page.getByRole('button', { name: 'Setări' }).click();
await expect(page.getByRole('dialog')).toBeHidden();await page.getByRole('button', { name: 'Accept toate' }).click();
await expect(page.getByRole('dialog')).toBeHidden();Fereastra se închide doar la „Accept toate”. „Setări” deschide alt panou, iar dialogul rămâne.
3Cererea a eșuat, deci indicatorul rămâne
await page.route('**/api/products*', (r) => r.abort());
await page.goto('/#/catalog');
await expect(page.getByTestId('loading')).toBeHidden();await page.route('**/api/products*', (r) => r.abort());
await page.goto('/#/catalog');
await expect(page.getByTestId('catalog-error')).toBeVisible();Când simulezi o eroare, verifică ce afișează aplicația pentru eroare. Un indicator blocat poate fi chiar bug-ul de raportat.
Repară eroarea, direct în pagină
Testul indicatorul de încărcare dispare pică cu expect(locator).toBeHidden() failed: în acest mediu, catalogul ShopRapid primește produsele abia după 6 secunde, iar aserțiunea așteaptă implicit 5. Repară aserțiunea astfel încât să aștepte până la 10 secunde doar în acest pas, apoi verifică că s-au încărcat 8 produse și afișează textul din results-count.
import { test, expect } from '@playwright/test';
test('indicatorul de încărcare dispare', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('loading')).toBeHidden();
await expect(page.getByTestId('product-card')).toHaveCount(8);
});Indiciu
Aserțiunile primesc o opțiune de timeout proprie.
Reparația
import { test, expect } from '@playwright/test';
test('indicatorul de încărcare dispare', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('loading')).toBeHidden({ timeout: 10000 });
await expect(page.getByTestId('product-card')).toHaveCount(8);
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
Indicatorul „Se încarcă produsele...” rămâne vizibil 6 secunde, iar toBeHidden() renunța după 5. Cu toBeHidden({ timeout: 10000 }), aserțiunea așteaptă cât e nevoie, dar trece imediat ce indicatorul dispare (nu stă 10 secunde fix).
Timeout-ul mărit e pus doar pe pasul lent, nu în config pentru toate aserțiunile, ca restul testelor să pice repede când chiar e o problemă. Verificarea celor 8 produse dovedește că încărcarea s-a terminat cu succes, nu doar că indicatorul a dispărut.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toBeHidden()Error: expect(locator).toBeHidden() failed Expected: hidden Received: visibleError: expect(locator).not.toBeHidden() failed
Cum o eviți pe viitor
- Pentru indicatorii de încărcare lenți, pune
{ timeout }doar pe aserțiunea respectivă și notează de ce. - Verifică după ascundere și rezultatul (lista apare, mesajul de succes), nu doar dispariția indicatorului.
- Locatorii preciși (
getByTestId,getByRolecuname) evită să prinzi alt element cu același text. - Nu înlocui aserțiunea cu
waitForTimeout: așteaptă prea mult când merge repede și prea puțin când e lent.
Întrebări frecvente
toBeHidden trece dacă elementul nu există deloc?
Da. Un element lipsă e considerat ascuns. De aceea un locator greșit (care nu găsește nimic) face ca toBeHidden să treacă mereu: verifică întâi, cu toBeVisible, că locatorul chiar găsește elementul.
E mai bine not.toBeVisible() sau toBeHidden()?
Sunt echivalente. toBeHidden() se citește mai ușor și e forma recomandată în documentația Playwright.
Erori înrudite
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. 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ă. TimeoutError: page.waitForSelector: Timeout 30000ms exceeded. 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(). Î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.
