...
Eroare Testare automată · Locatori: strict mode și selectori greșiți

Error: locator.click: Error: strict mode violation: getByRole('button', { name: 'Adaugă în coș' }) resolved to 8 elements

Pe scurt

Locatorul pe care faci click găsește mai multe elemente, iar Playwright refuză să ghicească pe care să-l apese. Fă locatorul unic: restrânge căutarea la containerul potrivit (cardul produsului, cu filter({ hasText })), folosește un nume accesibil unic sau un data-testid.

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

Ce înseamnă

Locatorii Playwright sunt stricți: o acțiune (click, fill, check) trebuie să găsească exact un element. Dacă găsește mai multe, testul se oprește cu strict mode violation: <locator> resolved to N elements.

Sub mesaj, Playwright listează elementele găsite, fiecare cu HTML-ul lui și o sugestie aka getByRole(...) / aka getByTestId(...), adică un locator care l-ar găsi doar pe el. Lista te ajută să vezi ce elemente se potrivesc și ce le deosebește.

Regula e făcută ca să te protejeze: un click pe „primul buton care se potrivește” ar putea apăsa alt produs decât cel din test, iar testul ar trece fals. De aceea alegi elementul după ceva care îl identifică (textul cardului, numele accesibil), nu după poziție.

De ce apare: cauzele frecvente

1Același buton se repetă în fiecare card

Greșit
JavaScript
await page.getByRole('button', { name: 'Adaugă în coș' }).click();
Corect
JavaScript
const card = page.getByTestId('product-card').filter({ hasText: 'Mouse ergonomic' });
await card.getByRole('button', { name: 'Adaugă în coș' }).click();

În catalog există 8 butoane identice. Cardul filtrat după numele produsului conține unul singur.

2Textul căutat apare de mai multe ori pe pagină

Greșit
JavaScript
await page.getByText('Catalog').click();
Corect
JavaScript
await page.getByRole('link', { name: 'Catalog', exact: true }).click();

getByText caută subșiruri: „Catalog” apare și în meniu, și în „Vezi catalogul”. Rolul plus exact: true lasă un singur element.

3Elementul are un nume accesibil unic, nefolosit

Greșit
JavaScript
await page.getByRole('button', { name: 'Șterge' }).click();
Corect
JavaScript
await page.getByRole('button', { name: 'Șterge adresa Strada Lalelelor 5' }).click();

Când butoanele au aria-label diferit, numele complet e cel mai simplu locator unic.

Repară tu

Repară eroarea, direct în pagină

Testul adaug mouse-ul în coș pică cu strict mode violation: getByRole('button', { name: 'Adaugă în coș' }) resolved to 8 elements. În catalogul ShopRapid fiecare produs e un card (data-testid="product-card") cu numele produsului și butonul „Adaugă în coș”. Repară testul ca să adauge în coș produsul Mouse ergonomic, fără să alegi butonul după poziție, apoi verifică că cart-count arată 1.

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

test('adaug mouse-ul în coș', async ({ page }) => {
  await page.goto('/#/catalog');
  await page.getByRole('button', { name: 'Adaugă în coș' }).click();

  await expect(page.getByTestId('cart-count')).toHaveText('1');
});
Indiciu

Găsește întâi cardul care conține textul „Mouse ergonomic”, apoi butonul din el.

Alte forme ale mesajului

  • Error: locator.fill: Error: strict mode violation: getByLabel('Email') resolved to 2 elements
  • Error: locator.textContent: Error: strict mode violation: getByTestId('product-price') resolved to 8 elements
  • Error: strict mode violation: locator('button') resolved to 3 elements

Cum o eviți pe viitor

  • Gândește locatorul ca un utilizator: „butonul Adaugă în coș din cardul Mouse ergonomic”, nu „primul buton”.
  • Înlănțuie locatorii: page.getByTestId('product-card').filter({ hasText: '...' }).getByRole('button').
  • Folosește exact: true când textul e subșir al altor texte.
  • Evită .first() / .nth() pentru a scăpa de eroare: le folosești doar când poziția chiar contează (de exemplu primul rezultat după sortare).

Întrebări frecvente

Pot rezolva rapid cu .first()?

Eroarea dispare, dar testul devine fragil: apasă primul element, oricare ar fi el. Dacă ordinea se schimbă, testul adaugă alt produs și poate trece fals. Folosește .first() doar când chiar vrei primul element.

De ce toHaveCount nu dă strict mode violation?

Pentru că toHaveCount, count(), all() și allTextContents() lucrează intenționat cu mai multe elemente. Regula strictă se aplică acțiunilor și aserțiunilor pe un singur element (toHaveText cu un text, toBeVisible).

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.