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

Error: toBeVisible can be only used with Locator object

Pe scurt

Ai dat unei aserțiuni pentru elemente (toBeVisible, toHaveText, toBeChecked...) o valoare deja citită (un text, un boolean, un ElementHandle) în loc de locator. Scrie expect(page.getByText('...')).toBeVisible(), fără await în interiorul lui expect.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Aserțiunile web-first ale Playwright (toBeVisible, toHaveText, toHaveValue, toBeChecked, toHaveCount...) lucrează pe un Locator: îl reevaluează la fiecare încercare, timp de 5 secunde. Mesajul toBeVisible can be only used with Locator object spune că expect a primit altceva: de obicei rezultatul lui await locator.textContent(), await locator.isVisible(), un ElementHandle de la page.$() sau un locator pus într-un await (expect(await page.getByText('x'))).

Aceeași familie de mesaje: toHaveURL can be only used with Page object (ai dat page.url() în loc de page) și toBeOK can be only used with APIResponse object (ai dat await raspuns.json() în loc de răspuns). Reparația e mereu aceeași: dai lui expect obiectul viu (locator, page, răspuns), nu o valoare citită din el.

De ce apare: cauzele frecvente

1Ai citit textul înainte de aserțiune

Greșit
JavaScript
const mesaj = await page.getByRole('alert').textContent();
await expect(mesaj).toBeVisible();
Corect
JavaScript
await expect(page.getByRole('alert')).toBeVisible();

mesaj e un string, nu un element. Aserțiunea are nevoie de locator ca să poată reîncerca.

2ElementHandle de la page.$()

Greșit
JavaScript
const buton = await page.$('[data-testid="login-submit"]');
await expect(buton).toBeEnabled();
Corect
JavaScript
const buton = page.getByTestId('login-submit');
await expect(buton).toBeEnabled();

page.$ întoarce un ElementHandle (API vechi). Locatorii sunt cei acceptați de aserțiuni.

3URL-ul în loc de pagină

Greșit
JavaScript
await expect(page.url()).toHaveURL(/catalog/);
Corect
JavaScript
await expect(page).toHaveURL(/catalog/);

toHaveURL citește singur adresa paginii și reîncearcă; page.url() e doar un string.

Repară tu

Repară eroarea, direct în pagină

Testul parolă greșită afișează mesajul pică cu o eroare de tip toBeVisible can be only used with Locator object: lui expect i se dă textul deja citit, nu elementul. Repară testul ca să verifice cu aserțiuni pe locator că mesajul role=alert e vizibil și are textul Email sau parolă greșită, apoi afișează textul.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('parolă greșită afișează mesajul', async ({ page }) => {
  await page.goto('/#/login');
  await page.getByLabel('Email').fill('ana@shoprapid.ro');
  await page.getByLabel('Parolă').fill('Gresit123');
  await page.getByRole('button', { name: 'Intră în cont' }).click();
  const mesaj = await page.getByRole('alert').textContent();
  await expect(mesaj).toBeVisible();
});
Indiciu

expect are nevoie de elementul viu, nu de textul lui.

Alte forme ale mesajului

  • Error: toHaveText can be only used with Locator object
  • Error: toBeEnabled can be only used with Locator object
  • Error: toHaveURL can be only used with Page object
  • Error: toBeOK can be only used with APIResponse object

Cum o eviți pe viitor

  • Nu pune await în interiorul lui expect(...) la aserțiunile pentru elemente: await se pune în fața lui expect.
  • Ține locatorii în variabile fără await: const alerta = page.getByRole('alert').
  • Folosește locatori în loc de page.$ / page.$$.
  • Pentru valori deja citite, folosește aserțiunile generice (toBe, toContain), nu pe cele web-first.

Întrebări frecvente

De ce nu pot verifica vizibilitatea unui string?

Un string nu e un element; nu are poziție, stil sau stare. Vizibilitatea se verifică doar pe ceva din pagină, adică pe un locator.

Și dacă am deja textul și vreau să-l verific?

Folosește aserțiunile pentru valori: expect(text).toBe('...'). Dar dacă textul e din pagină, expect(locator).toHaveText('...') e mai sigur, fiindcă așteaptă.

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.