...
← Curs Test Automation (Playwright și Selenium): toate lecțiile
Lecția 9 · Locatori

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.

Exercițiul tău

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: ... }).
await expect(page.getByRole('link', { name: 'Despre noi' })).toBeVisible(); și la fel pentru celelalte două.

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();
});
Excelent! Continuă cu lecția următoare →
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ă.

HTMLRolCum î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.
Important

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.
tests/exemplu.spec.jsPlaywright
Previzualizare
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași în automatizarea testelor Lecția 9 · getByRole: elementele după rol
Progres 0% 0 din 22
Lecția curentă 9 / 20 Locatori