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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Playwright tratează orice selector care începe cu // sau .. (ori are prefixul xpath=) ca XPath și îl dă browserului spre evaluare cu document.evaluate. Dacă expresia nu respectă gramatica XPath, browserul aruncă SyntaxError: Failed to execute 'evaluate' on 'Document': The string '...' is not a valid XPath expression., iar Playwright o raportează la acțiunea care a folosit locatorul (locator.click, locator.count...).
În mesaj vezi exact expresia primită. Cauzele obișnuite: [ fără ], ( fără ), ghilimele de același fel în interiorul șirului ('//a[text()='Detalii']' în JavaScript se rupe), un @ uitat la atribut sau o funcție scrisă greșit (contain() în loc de contains()). Eroarea apare imediat, nu după timeout. XPath-ul copiat din DevTools e și fragil: preferă locatorii după rol și text.
De ce apare: cauzele frecvente
1Paranteză dreaptă neînchisă
await page.locator('//button[text()="Adaugă în coș"').first().click();await page.locator('//button[text()="Adaugă în coș"]').first().click();Predicatul [ ... ] trebuie închis. Fără ], expresia nu e XPath valid.
2Funcție scrisă greșit
page.locator('//div[contain(@class, "card")]')page.locator('//div[contains(@class, "card")]')Funcția XPath se numește contains. Un nume necunoscut face expresia invalidă.
3XPath unde un locator după rol e mai clar
page.locator('//nav//a[normalize-space()="Catalog"]')page.getByRole('navigation').getByRole('link', { name: 'Catalog' })getByRole nu are sintaxă de greșit și rezistă la schimbări de structură.
Repară eroarea, direct în pagină
Testul adaugă primul produs din catalog pică imediat cu is not a valid XPath expression: XPath-ul pentru butonul „Adaugă în coș” are o greșeală de sintaxă. Repară selectorul (fie închizi expresia, fie folosești getByRole), ca testul să verifice notificarea care conține a fost adăugat în coș și să o afișeze.
import { test, expect } from '@playwright/test';
test('adaugă primul produs din catalog', async ({ page }) => {
await page.goto('/#/catalog');
await page.locator('//button[text()="Adaugă în coș"').first().click();
await expect(page.getByRole('status')).toContainText('a fost adăugat în coș');
console.log(await page.getByRole('status').textContent());
});Indiciu
Numără parantezele drepte din expresie.
Reparația
import { test, expect } from '@playwright/test';
test('adaugă primul produs din catalog', async ({ page }) => {
await page.goto('/#/catalog');
await page.locator('//button[text()="Adaugă în coș"]').first().click();
await expect(page.getByRole('status')).toContainText('a fost adăugat în coș');
console.log(await page.getByRole('status').textContent());
});De ce merge
Expresia //button[text()="Adaugă în coș" deschidea predicatul cu [ și nu îl închidea, deci nu era XPath valid, iar evaluarea a fost refuzată înainte de orice căutare. Cu ] la final (sau cu getByRole('button', { name: 'Adaugă în coș' })), locatorul găsește cele 8 butoane, first() îl alege pe primul, iar click-ul adaugă produsul.
Notificarea apare după răspunsul serverului; toContainText o așteaptă.
Alte forme ale mesajului
Error: locator.click: SyntaxError: Failed to execute 'evaluate' on 'Document': The string '//button[' is not a valid XPath expression.SyntaxError: Document.evaluate: The expression is not a legal expressionError: locator.count: Failed to execute 'evaluate' on 'Document': The string '//div[@class=card' is not a valid XPath expression.
Cum o eviți pe viitor
- Preferă
getByRole,getByText,getByTestId; folosește XPath doar când nu ai altă cale (de exemplu navigare la părinte). - Pentru șiruri cu ghilimele, folosește în JavaScript backticks sau alt tip de ghilimele decât în XPath.
- Verifică expresia în consola browserului cu
$x('//...')înainte s-o pui în test.
Întrebări frecvente
De ce greșeala apare imediat, nu după 30 de secunde?
Fiindcă expresia nu poate fi nici măcar evaluată. Un XPath valid care nu găsește nimic ar aștepta până la timeout; unul invalid e refuzat din prima.
Pot folosi XPath cu getByRole în același lanț?
Da: page.getByTestId('cart-table').locator('xpath=..') urcă la părinte. Înlănțuirea merge cu orice tip de locator.
Erori înrudite
InvalidSelectorError: invalid selector: An invalid or illegal selector was specified Selectorul nu e valid pentru metoda aleasă: de obicei un XPath dat lui By.css (By.css("//button")), o paranteză nedeschisă sau neînchisă, sau o pseudo-clasă care nu există în CSS (:contains). Folosește By.xpath pentru XPath și verifică selectorul CSS în consola browserului. 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. 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.
