Error: toBeVisible can be only used with Locator object
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
const mesaj = await page.getByRole('alert').textContent();
await expect(mesaj).toBeVisible();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.$()
const buton = await page.$('[data-testid="login-submit"]');
await expect(buton).toBeEnabled();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ă
await expect(page.url()).toHaveURL(/catalog/);await expect(page).toHaveURL(/catalog/);toHaveURL citește singur adresa paginii și reîncearcă; page.url() e doar un string.
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.
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.
Reparația
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 alerta = page.getByRole('alert');
await expect(alerta).toBeVisible();
await expect(alerta).toHaveText('Email sau parolă greșită');
console.log(await alerta.textContent());
});De ce merge
await page.getByRole('alert').textContent() întoarce un string, iar toBeVisible() nu poate verifica vizibilitatea unui text. Pe lângă asta, citirea se făcea imediat, poate înainte să apară mesajul.
Cu expect(page.getByRole('alert')), aserțiunea primește locatorul, îl caută din nou la fiecare încercare și așteaptă până la 5 secunde. toHaveText verifică și conținutul. Abia după aserțiuni textul se citește sigur pentru afișare.
Alte forme ale mesajului
Error: toHaveText can be only used with Locator objectError: toBeEnabled can be only used with Locator objectError: toHaveURL can be only used with Page objectError: toBeOK can be only used with APIResponse object
Cum o eviți pe viitor
- Nu pune
awaitîn interiorul luiexpect(...)la aserțiunile pentru elemente:awaitse pune în fața luiexpect. - Ț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
Error: expect(received).toBeTruthy() Valoarea verificată e falsă (false, 0, "", null sau undefined). În testele UI apare des la expect(await locator.isVisible()).toBeTruthy(): isVisible() citește o singură dată, înainte ca elementul să apară. Înlocuiește cu await expect(locator).toBeVisible(), care așteaptă. 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. TypeError: page.getByRol is not a function Ai apelat o metodă care nu există, de obicei din cauza unei greșeli de scriere: getByRol în loc de getByRole, getByLable, toHaveUrl. Corectează numele exact al metodei; literele mari contează, iar editorul cu autocomplete (VS Code) te ajută să le alegi corect. Î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.
