...
Eroare Testare automată · Aserțiuni expect care pică

Error: expect(locator).toBeVisible() failed

Pe scurt

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

Greșit
JavaScript
await expect(page.getByTestId('product-card').first()).toBeVisible();
Corect
JavaScript
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

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

Greșit
JavaScript
await expect(page.locator('.toast-success')).toBeVisible();
Corect
JavaScript
await expect(page.getByRole('status')).toBeVisible();

Clasa nu există pe pagină, deci Received: <element(s) not found>.

Repară tu

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.

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

Alte forme ale mesajului

  • Error: Timed out 5000ms waiting for expect(locator).toBeVisible()
  • Error: expect(locator).toBeVisible() failed Expected: visible Received: hidden
  • Error: expect(locator).not.toBeVisible() failed

Cum o eviți pe viitor

  • Pentru o operație lentă știută, pune { timeout } doar pe aserțiunea respectivă sau test.slow() pe test.
  • Nu mări expect.timeout global 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

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