Error: expect(locator).toHaveRole(expected) failed
Rolul ARIA al elementului e altul decât cel din test. Des: input type=search are rolul searchbox (nu textbox), type=number e spinbutton, un div stilizat ca buton nu are rol (Received: null). Folosește rolul din Received sau, dacă e un bug de accesibilitate, raportează-l.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toHaveRole(rol) compară rolul ARIA calculat al elementului cu rolul dat. Rolul vine din atributul role sau, implicit, din tipul elementului: <button> = button, <a href> = link, <input type="text"> = textbox, <input type="search"> = searchbox, <input type="number"> = spinbutton, <input type="checkbox"> = checkbox, <select> = combobox, <ul> = list. Un div sau span fără role nu are rol, deci raportul arată Received: null.
Când pică, ori ai presupus alt rol (cazul searchbox e cel mai frecvent), ori aplicația chiar are o problemă: un buton făcut din div nu e anunțat de cititoarele de ecran și nu se poate folosi de la tastatură. În al doilea caz testul a găsit un bug, iar reparația e în aplicație. Același rol îl folosește getByRole, deci o greșeală aici explică și de ce un locator după rol nu găsește nimic.
De ce apare: cauzele frecvente
1Câmp de căutare tratat ca textbox
await expect(page.getByLabel('Caută')).toHaveRole('textbox');await expect(page.getByLabel('Caută')).toHaveRole('searchbox');input type=search are rolul implicit searchbox.
2Câmp numeric tratat ca textbox
await expect(page.getByLabel('Cantitate')).toHaveRole('textbox');await expect(page.getByLabel('Cantitate')).toHaveRole('spinbutton');input type=number are rolul spinbutton (are săgeți de creștere și scădere).
3Buton făcut dintr-un div
<div class="btn" onclick="salveaza()">Salvează</div><button type="button" onclick="salveaza()">Salvează</button>Un div nu are rol (Received: null). Reparația e în aplicație: un buton real are rol, focus și tastatură.
Repară eroarea, direct în pagină
Testul căutarea din catalog e accesibilă pică cu expect(locator).toHaveRole(expected) failed (Expected: "textbox"). Câmpul Caută din catalogul ShopRapid e un input type="search". Repară rolul așteptat, apoi testul caută mouse cu Enter și afișează textul din results-count (1 produs).
import { test, expect } from '@playwright/test';
test('căutarea din catalog e accesibilă', async ({ page }) => {
await page.goto('/#/catalog');
const cauta = page.getByLabel('Caută');
await expect(cauta).toHaveRole('textbox');
await cauta.fill('mouse');
await cauta.press('Enter');
await expect(page.getByTestId('results-count')).toHaveText('1 produs');
console.log(await page.getByTestId('results-count').textContent());
});Indiciu
Ce rol implicit are un input de tip search?
Reparația
import { test, expect } from '@playwright/test';
test('căutarea din catalog e accesibilă', async ({ page }) => {
await page.goto('/#/catalog');
const cauta = page.getByLabel('Caută');
await expect(cauta).toHaveRole('searchbox');
await cauta.fill('mouse');
await cauta.press('Enter');
await expect(page.getByTestId('results-count')).toHaveText('1 produs');
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
Un input type="search" are rolul implicit searchbox, nu textbox, deci aserțiunea compara rolul real cu unul presupus. Cu searchbox trece. Restul testului caută produsul, iar toHaveText('1 produs') așteaptă rezultatul filtrării. Același rol îl folosesc și locatorii: getByRole('searchbox', { name: 'Caută' }) găsește câmpul, iar getByRole('textbox', { name: 'Caută' }) nu.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toHaveRole(expected)Error: expect(locator).not.toHaveRole(expected) failed
Cum o eviți pe viitor
- Învață rolurile implicite pentru elementele din formularele tale (textbox, searchbox, spinbutton, combobox, checkbox, radio).
- Verifică rolul în DevTools (panoul Accessibility) sau în UI mode, înainte de a scrie
getByRole. - Când găsești elemente fără rol pe care se dă click, raportează-le ca bug de accesibilitate.
Întrebări frecvente
De ce getByRole('textbox', { name: 'Caută' }) nu găsește câmpul?
Fiindcă un input type="search" are rolul searchbox. Folosește getByRole('searchbox', { name: 'Caută' }) sau getByLabel('Caută').
Câmpul de parolă ce rol are?
textbox. Nu există un rol separat pentru parolă, deci getByRole('textbox') pe o pagină de login găsește și emailul, și parola.
Erori înrudite
Error: expect(locator).toHaveAccessibleName(expected) failed Numele accesibil al elementului (cel citit de cititoarele de ecran și folosit de getByRole) diferă de textul așteptat. La butoanele cu icon, numele vine din aria-label, nu din simbolul afișat (×, o lupă, trei linii). Verifică în Received numele real și compară cu el. 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ă. Error: locator.click: Error: strict mode violation: getByRole('button', { name: 'Adaugă în coș' }) resolved to 8 elements Locatorul pe care faci click găsește mai multe elemente, iar Playwright refuză să ghicească pe care să-l apese. Fă locatorul unic: restrânge căutarea la containerul potrivit (cardul produsului, cu filter({ hasText })), folosește un nume accesibil unic sau un data-testid. Î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.
