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.
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
await expect(page.getByTestId('close-modal')).toHaveAccessibleName('×');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ă
<label>Email</label>
<input id="email"><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ă
await expect(page.getByRole('link').first()).toHaveAccessibleName('detalii laptop');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ă 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.
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.
Reparația
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('Închide fereastra');
await inchide.click();
await expect(page.getByRole('dialog')).toBeHidden();
console.log('inchisa');
});De ce merge
Numele accesibil al butonului vine din aria-label, deci e „Închide fereastra”, nu simbolul × afișat. Aserțiunea compara simbolul cu numele real. Cu numele corect trece, iar click-ul închide fereastra, lucru pe care îl confirmă toBeHidden. Diferența contează și pentru locatori: getByRole('button', { name: 'Închide fereastra' }) găsește butonul, pe când același locator cu × nu găsește nimic.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toHaveAccessibleName(expected)Error: expect(locator).not.toHaveAccessibleName(expected) failedError: expect(locator).toHaveAccessibleDescription(expected) failed
Cum o eviți pe viitor
- Verifică numele accesibil la butoanele cu icon: fiecare trebuie să aibă
aria-labelclar. - 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
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. 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: expect(locator).toHaveText(expected) failed Textul elementului nu a devenit egal cu cel așteptat în 5 secunde. Compară rândurile Expected și Received: toHaveText cere tot textul elementului (cu spațiile normalizate), deci pentru o bucată din text folosește toContainText sau o expresie regulată. Î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.
