getByRole: elementele după rol
Un utilizator nu vede tag-uri HTML, vede „un buton”, „un link”, „un titlu”. Locatorul getByRole caută elementele exact așa: după rolul lor și după textul lor. Este locatorul recomandat de Playwright și îl vei folosi cel mai des.
Pagina din această lecție
<title>Newsletter</title> <h1>Noutăți de la magazin</h1> <p>Primește ofertele săptămânii direct pe email.</p> <a href="/despre.html">Despre noi</a> <button>Abonează-te</button>
Pagina are un titlu (h1), un paragraf, un link și un buton. Testele de mai jos rulează pe ea.
Pe pagina din lecție, scrie testul elementele paginii: verifică cu toBeVisible() titlul Noutăți de la magazin (rolul heading), linkul Despre noi (rolul link) și butonul Abonează-te (rolul button), toate găsite cu getByRole și name.
- Verifică titlul cu getByRole('heading', { name: ... }).
- Verifică linkul cu getByRole('link', { name: ... }).
- Verifică butonul cu getByRole('button', { name: ... }).
Soluția exercițiului
import { test, expect } from '@playwright/test';
test('elementele paginii', async ({ page }) => {
await page.goto('/');
await expect(page.getByRole('heading', { name: 'Noutăți de la magazin' })).toBeVisible();
await expect(page.getByRole('link', { name: 'Despre noi' })).toBeVisible();
await expect(page.getByRole('button', { name: 'Abonează-te' })).toBeVisible();
}); Vrei să afli mai mult?Ce este rolul unui element · getByRole cu name · De ce este locatorul recomandat · Greșeli frecvente · Rezumat
Ce este rolul unui element
Browserul atribuie fiecărui element un rol (din standardul ARIA, pentru accesibilitate), pe care îl folosesc și cititoarele de ecran pentru nevăzători. Rolul spune *ce este* elementul, indiferent cum arată.
| HTML | Rol | Cum îl descrie un cititor de ecran |
|---|---|---|
| <button>Abonează-te</button> | button | „buton Abonează-te” |
| <a href="...">Despre noi</a> | link | „link Despre noi” |
| <h1>...</h1> … <h6> | heading | „titlu nivel 1 ...” |
| <input type="text"> | textbox | „câmp de text ...” |
| <input type="checkbox"> | checkbox | „casetă de bifat ...” |
getByRole cu name
page.getByRole(rol, { name: 'text' }) găsește elementul cu rolul dat și numele accesibil dat. Pentru butoane, link-uri și titluri, numele accesibil este textul lor.
import { test, expect } from '@playwright/test';
test('butonul și titlul', async ({ page }) => {
await page.goto('/');
await expect(page.getByRole('button', { name: 'Abonează-te' })).toBeVisible();
await expect(page.getByRole('heading', { name: 'Noutăți de la magazin' })).toBeVisible();
console.log(await page.getByRole('link').textContent());
});
Running 1 test using 1 worker Despre noi ✓ 1 exemplu.spec.js › butonul și titlul 1 passed
Ultimul rând nu are name: getByRole('link') găsește toate link-urile, iar pe pagină există unul singur, „Despre noi”.
De ce este locatorul recomandat
- Testează ce vede utilizatorul: dacă butonul își schimbă textul în „Trimite”, testul pică și află și el, la fel ca un client.
- Rezistă la schimbări de design: developerul poate schimba culorile, clasele CSS sau poate muta butonul într-un alt div; rolul și textul rămân.
- Verifică accesibilitatea: dacă un „buton” este de fapt un <div> pe care se poate da click, nu are rolul button, iar getByRole nu îl găsește. Ai prins o problemă reală pentru utilizatorii cu cititoare de ecran.
Când ai de ales, începe cu getByRole. Vei vedea în curs și alți locatori (getByLabel, getByText, getByTestId, CSS), pentru situațiile în care rolul nu ajunge.
Greșeli frecvente
- Rolul scris greșit: getByRole('btn') sau getByRole('Button'). Rolurile se scriu exact, cu litere mici: button, link, heading.
- Confuzia link / buton: „Despre noi” duce la altă pagină, deci este link, nu button, chiar dacă arată ca un buton.
- Numele uitat pe o pagină cu mai multe butoane: Playwright nu știe pe care îl vrei (vei vedea eroarea *strict mode violation* mai târziu).
Rezumat
- Rolul spune ce este un element: button, link, heading, textbox, checkbox.
- page.getByRole('button', { name: 'Abonează-te' }) caută după rol și numele accesibil (textul).
- Este locatorul recomandat: seamănă cu felul în care utilizatorul vede pagina.
