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

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

Pe scurt

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.

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

Ce înseamnă

Numele accesibil e eticheta pe care tehnologiile asistive o anunță pentru un element. Se calculează după reguli fixe: aria-labelledby, apoi aria-label, apoi conținutul (la butoane și linkuri) sau eticheta <label> (la câmpuri), apoi title / alt. toHaveAccessibleName compară rezultatul acestui calcul cu textul tău și afișează Expected și Received.

Ce vezi pe ecran nu e mereu numele: un buton care afișează × cu aria-label="Închide fereastra" are numele „Închide fereastra”. O imagine fără alt într-un link poate da un nume gol (Received: ""), ceea ce e chiar un bug de accesibilitate. Același nume îl folosește getByRole('button', { name }), deci aserțiunea te ajută și să înțelegi de ce un locator după rol nu găsește elementul.

De ce apare: cauzele frecvente

1Simbolul afișat în loc de aria-label

Greșit
JavaScript
await expect(page.getByTestId('close-modal')).toHaveAccessibleName('×');
Corect
JavaScript
await expect(page.getByTestId('close-modal')).toHaveAccessibleName('Închide fereastra');

aria-label are prioritate față de conținut. Numele e textul din aria-label.

2Câmp fără etichetă legată

Greșit
JavaScript
<label>Email</label>
<input id="email">
Corect
JavaScript
<label for="email">Email</label>
<input id="email">

Fără for (sau input în interiorul label), câmpul nu primește numele etichetei. Aici reparația e în aplicație: testul a găsit un bug real.

3Spațiile și majusculele contează

Greșit
JavaScript
await expect(page.getByRole('link').first()).toHaveAccessibleName('detalii laptop');
Corect
JavaScript
await expect(page.getByRole('link').first()).toHaveAccessibleName('Detalii Laptop UltraBook 14');

Un text simplu se compară exact (cu spațiile normalizate). Pentru o parte din nume, folosește RegExp.

Repară tu

Repară eroarea, direct în pagină

Testul butonul de închidere are nume accesibil pică cu toHaveAccessibleName (Expected: "×", Received: "Închide fereastra"). Butonul afișează ×, dar are aria-label. Repară aserțiunea, apoi testul apasă butonul, verifică că fereastra (role=dialog) s-a închis și afișează inchisa.

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

test('butonul de închidere are nume accesibil', async ({ page }) => {
  await page.goto('/');
  const inchide = page.getByTestId('close-modal');
  await expect(inchide).toHaveAccessibleName('×');
  await inchide.click();
  await expect(page.getByRole('dialog')).toBeHidden();
  console.log('inchisa');
});
Indiciu

aria-label are prioritate față de conținutul butonului.

Alte forme ale mesajului

  • Error: Timed out 5000ms waiting for expect(locator).toHaveAccessibleName(expected)
  • Error: expect(locator).not.toHaveAccessibleName(expected) failed
  • Error: expect(locator).toHaveAccessibleDescription(expected) failed

Cum o eviți pe viitor

  • Verifică numele accesibil la butoanele cu icon: fiecare trebuie să aibă aria-label clar.
  • Folosește în teste getByRole(rol, { name }): dacă locatorul nu găsește butonul, ai aflat un bug de accesibilitate.
  • Inspectează numele în DevTools (panoul Accessibility) sau în UI mode, la „Pick locator”.

Întrebări frecvente

De ce getByRole nu găsește butonul după textul vizibil?

Fiindcă aria-label înlocuiește textul în numele accesibil. getByRole('button', { name: '×' }) nu se potrivește dacă numele e „Închide fereastra”.

Pot verifica doar o parte din nume?

Da, cu o expresie regulată: toHaveAccessibleName(/Închide/).

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.