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

Error: expect(locator).toHaveRole(expected) failed

Pe scurt

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

Greșit
JavaScript
await expect(page.getByLabel('Caută')).toHaveRole('textbox');
Corect
JavaScript
await expect(page.getByLabel('Caută')).toHaveRole('searchbox');

input type=search are rolul implicit searchbox.

2Câmp numeric tratat ca textbox

Greșit
JavaScript
await expect(page.getByLabel('Cantitate')).toHaveRole('textbox');
Corect
JavaScript
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

Greșit
JavaScript
<div class="btn" onclick="salveaza()">Salvează</div>
Corect
JavaScript
<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ă tu

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

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

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

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