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

Failed to execute 'evaluate' on 'Document': The string '//button[text()="Adaugă în coș"' is not a valid XPath expression.

Pe scurt

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ă

Greșit
JavaScript
await page.locator('//button[text()="Adaugă în coș"').first().click();
Corect
JavaScript
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

Greșit
JavaScript
page.locator('//div[contain(@class, "card")]')
Corect
JavaScript
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

Greșit
JavaScript
page.locator('//nav//a[normalize-space()="Catalog"]')
Corect
JavaScript
page.getByRole('navigation').getByRole('link', { name: 'Catalog' })

getByRole nu are sintaxă de greșit și rezistă la schimbări de structură.

Repară tu

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.

Codul care dă eroarea
JavaScript
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.

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 expression
  • Error: 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

← 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.