Error: locator.click: Unknown engine "testid" while parsing selector testid=cart-count
Playwright a citit textul dinaintea semnului = din selector ca nume de motor de selectori (css, xpath, text, id, data-testid...) și nu cunoaște motorul testid. Scrie selectorul corect: page.getByTestId('cart-count'), page.locator('[data-testid="cart-count"]') sau, pentru text, getByText.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În page.locator(...), un selector de forma nume=valoare înseamnă „folosește motorul de selectori nume”. Playwright are motoare precum css=, xpath=, text=, id=, data-testid=, internal:role=. Când numele nu e unul dintre ele, refuză selectorul înainte să caute ceva: Unknown engine "testid" while parsing selector testid=cart-count.
Greșeala apare de obicei din trei surse: un prefix inventat sau scurtat (testid=, role=button, label=Email), o sintaxă din alt instrument copiată în Playwright, sau un selector CSS de atribut scris fără paranteze drepte (name=email în loc de [name="email"]). Eroarea vine imediat, nu după timeout, și indică exact selectorul. Reparația: folosește metoda dedicată (getByTestId, getByRole, getByLabel) sau CSS valid.
De ce apare: cauzele frecvente
1Prefix inventat pentru data-testid
await page.locator('testid=cart-count').click();await page.getByTestId('cart-count').click();Nu există motorul testid. getByTestId citește atributul configurat (implicit data-testid).
2Atribut CSS fără paranteze drepte
await page.locator('name=email').fill('ana@shoprapid.ro');await page.locator('[name="email"]').fill('ana@shoprapid.ro');În CSS, un atribut se scrie între paranteze drepte. Fără ele, name= e citit ca motor de selectori.
3Sintaxă de rol scrisă de mână
await page.locator('role=button[name="Aplică"]').click();await page.getByRole('button', { name: 'Aplică' }).click();Selectorul de rol are forma internă internal:role=...; în teste folosești getByRole.
Repară eroarea, direct în pagină
Testul adaugă un produs în coș pică imediat cu Unknown engine "testid" while parsing selector testid=cart-count. Numărul din coș are data-testid="cart-count". Repară locatorul ca testul să verifice că, după click pe primul „Adaugă în coș”, numărul din antet devine 1, apoi afișează-l.
import { test, expect } from '@playwright/test';
test('adaugă un produs în coș', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByRole('button', { name: 'Adaugă în coș' }).first().click();
const numar = page.locator('testid=cart-count');
await expect(numar).toHaveText('1');
console.log(await numar.textContent());
});Indiciu
Playwright are o metodă dedicată pentru atributul data-testid.
Reparația
import { test, expect } from '@playwright/test';
test('adaugă un produs în coș', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByRole('button', { name: 'Adaugă în coș' }).first().click();
const numar = page.getByTestId('cart-count');
await expect(numar).toHaveText('1');
console.log(await numar.textContent());
});De ce merge
testid=cart-count a fost citit ca selector cu motorul testid, care nu există, așa că Playwright a oprit testul înainte de orice căutare. getByTestId('cart-count') caută atributul data-testid (cel configurat în proiect).
Aserțiunea toHaveText('1') așteaptă ca cererea de adăugare să se termine și numărul din antet să se actualizeze, apoi textContent îl citește pentru afișare.
Alte forme ale mesajului
Error: locator.fill: Unknown engine "name" while parsing selector name=emailError: page.click: Unknown engine "label" while parsing selector label=EmailError: Unknown engine "role" while parsing selector role=button
Cum o eviți pe viitor
- Folosește metodele
getBy...în loc de selectori scriși de mână. - Când ai nevoie de CSS, scrie CSS valid (
[data-testid="x"],#id,.clasa) și verifică-l în consola browserului cudocument.querySelector. - Generează selectorii cu
npx playwright codegensau cu butonul „Pick locator” din UI mode.
Întrebări frecvente
Ce motoare de selectori există?
Cele des folosite: css= (implicit), xpath= (implicit pentru //...), text=, id=, data-testid=, data-test-id=, data-test=. Pentru restul, metodele getByRole, getByLabel, getByText sunt varianta recomandată.
De ce data-testid=cart-count merge, iar testid=cart-count nu?
Fiindcă data-testid e chiar numele unui motor din Playwright, iar testid nu. Totuși, getByTestId e mai clar și respectă testIdAttribute din config.
Erori înrudite
Failed to execute 'evaluate' on 'Document': The string '//button[text()="Adaugă în coș"' is not a valid XPath expression. Selectorul XPath are o greșeală de sintaxă, de obicei o paranteză dreaptă sau rotundă neînchisă ori ghilimele amestecate, iar browserul refuză să-l evalueze. Închide parantezele și ghilimelele sau, mai bine, înlocuiește XPath-ul cu getByRole / getByText. TypeError: page.getByRol is not a function Ai apelat o metodă care nu există, de obicei din cauza unei greșeli de scriere: getByRol în loc de getByRole, getByLable, toHaveUrl. Corectează numele exact al metodei; literele mari contează, iar editorul cu autocomplete (VS Code) te ajută să le alegi corect. Received: <element(s) not found> Aserțiunea nu a găsit niciun element pentru locatorul dat, deci selectorul e greșit sau elementul nu există pe pagina curentă. Verifică în pagină cum poate fi găsit elementul (rol, text, data-testid) și scrie locatorul după asta, nu după un id sau o clasă presupusă. Î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.
