← Back to library
Playwrightselectorsbeginnerv1.20+

getByRole — click a button by name

Locate a button by its accessible role and visible name — the most resilient selector strategy.

1test('saves changes using getByRole', async ({ page }) => {
2  await page.goto('/settings');
3
4  // getByRole matches what screen readers see — survives CSS and text refactors
5  await page.getByRole('button', { name: 'Save changes' }).click();
6
7  await expect(page.getByText('Settings saved')).toBeVisible();
8});
#getByRole#button#accessible name#ARIA