Error: locator.click: Error: strict mode violation: getByRole('button', { name: 'Adaugă în coș' }) resolved to 8 elements
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
await page.getByRole('button', { name: 'Adaugă în coș' }).click();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ă
await page.getByText('Catalog').click();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
await page.getByRole('button', { name: 'Șterge' }).click();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ă 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.
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.
Reparația
import { test, expect } from '@playwright/test';
test('adaug mouse-ul în coș', async ({ page }) => {
await page.goto('/#/catalog');
const card = page.getByTestId('product-card').filter({ hasText: 'Mouse ergonomic' });
await card.getByRole('button', { name: 'Adaugă în coș' }).click();
await expect(page.getByTestId('cart-count')).toHaveText('1');
});De ce merge
Pe pagină sunt 8 butoane „Adaugă în coș”, unul în fiecare card, iar locatorul inițial le găsea pe toate. page.getByTestId('product-card').filter({ hasText: 'Mouse ergonomic' }) păstrează doar cardul mouse-ului, iar card.getByRole('button', ...) caută butonul doar în interiorul lui, deci găsește exact unul.
Spre deosebire de .nth(5), locatorul ăsta rămâne corect dacă se schimbă ordinea produselor. toHaveText('1') pe cart-count așteaptă ca aplicația să termine adăugarea.
Alte forme ale mesajului
Error: locator.fill: Error: strict mode violation: getByLabel('Email') resolved to 2 elementsError: locator.textContent: Error: strict mode violation: getByTestId('product-price') resolved to 8 elementsError: 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: truecâ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
Error: expect.toHaveText: Error: strict mode violation: getByTestId('product-price') resolved to 8 elements Aserțiunea toHaveText cu un singur text a primit un locator care găsește mai multe elemente, de exemplu toate prețurile din catalog. Restrânge locatorul la elementul pe care vrei să-l verifici (cardul produsului, rândul din tabel) sau, dacă vrei să verifici toate elementele, dă-i lui toHaveText o listă de texte. Error: expect(locator).toHaveCount(expected) failed Locatorul a găsit alt număr de elemente decât ai cerut. Ori locatorul e prea larg (prinde și alte elemente cu același text) sau prea îngust, ori aplicația chiar afișează alt număr. Compară Expected cu Received și numără elementele care te interesează, de exemplu cardurile de produs după data-testid. Test timeout of 30000ms exceeded. Testul a depășit timpul maxim (implicit 30 de secunde) pentru că a așteptat ceva ce nu s-a întâmplat: de obicei un element pe care locatorul nu îl găsește. Citește call log-ul de sub mesaj, vezi ce locator aștepta și corectează-l după rolul și textul real din pagină. Î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.
