Error: locator.click: Unexpected token "]" while parsing css selector "button[data-testid=add-to-cart]]". Did you mean to CSS.escape it?
Selectorul CSS dat lui locator() nu e valid: o paranteză în plus sau lipsă, ghilimele neînchise, un id care începe cu cifră. Mesajul arată caracterul la care s-a oprit parserul. Repară selectorul sau, mai simplu, folosește getByTestId / getByRole, care nu au sintaxă CSS.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Playwright citește textul din page.locator('...') ca selector CSS (dacă nu începe cu //, xpath=, text= etc.). Când întâlnește un caracter care nu are sens în acel loc, oprește parsarea și spune: Unexpected token "]" = caracterul problematic, while parsing css selector "..." = selectorul complet. Sugestia Did you mean to CSS.escape it? apare fiindcă unele caractere (:, ., [, # la început de id, cifra de la începutul unui id) trebuie scăpate cu \\ într-un selector.
Eroarea apare la prima acțiune pe locator (click, fill, count), nu la crearea lui, deoarece locatorii sunt leneși. Uită-te la selector caracter cu caracter: perechile [ ] și ( ), ghilimelele, spațiile din valorile de atribut. Dacă selectorul e lung și fragil, înlocuiește-l cu un locator după rol sau după data-testid.
De ce apare: cauzele frecvente
1Paranteză pătrată în plus
await page.locator('button[data-testid=add-to-cart]]').first().click();await page.getByTestId('add-to-cart').first().click();Al doilea ] nu închide nimic. getByTestId nu are nevoie de sintaxă CSS deloc.
2Valoare de atribut cu spații, fără ghilimele
page.locator('[aria-label=Adaugă în coș]')page.locator('[aria-label="Adaugă în coș"]')Fără ghilimele, valoarea se oprește la primul spațiu și restul devine sintaxă invalidă.
3Id care începe cu o cifră
page.locator('#123-produs')page.locator('[id="123-produs"]')În CSS, un id după # nu poate începe cu cifră fără escape. Selectorul de atribut nu are restricția.
Repară eroarea, direct în pagină
Testul adaugă primul produs în coș pică la click cu Unexpected token "]" while parsing css selector. Repară locatorul butonului „Adaugă în coș” din primul card al catalogului, apoi verifică și afișează numărul din cart-count, care trebuie să fie 1.
import { test, expect } from '@playwright/test';
test('adaugă primul produs în coș', async ({ page }) => {
await page.goto('/#/catalog');
await page.locator('button[data-testid=add-to-cart]]').first().click();
await expect(page.getByTestId('cart-count')).toHaveText('1');
console.log(await page.getByTestId('cart-count').textContent());
});Indiciu
Numără parantezele pătrate din selector, sau renunță la CSS.
Reparația
import { test, expect } from '@playwright/test';
test('adaugă primul produs în coș', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByTestId('add-to-cart').first().click();
await expect(page.getByTestId('cart-count')).toHaveText('1');
console.log(await page.getByTestId('cart-count').textContent());
});De ce merge
Selectorul avea un ] în plus la final, deci parserul CSS s-a oprit acolo și Playwright a aruncat eroarea înainte să caute vreun element. getByTestId('add-to-cart') găsește aceleași butoane fără sintaxă CSS; .first() alege butonul din primul card, iar după click coșul arată 1.
Alte forme ale mesajului
Error: locator.fill: Unexpected token "=" while parsing css selector "input[name==email]". Did you mean to CSS.escape it?Error: locator.count: Unexpected token ")" while parsing css selector "div:has-text('Coș'))". Did you mean to CSS.escape it?SyntaxError: Failed to execute 'querySelectorAll' on 'Document': 'button]' is not a valid selector.
Cum o eviți pe viitor
- Preferă
getByRole,getByLabel,getByTestId: nu au sintaxă CSS, deci nu pot avea paranteze greșite. - Pune mereu valorile de atribut între ghilimele:
[data-testid="cart-count"]. - Testează un selector CSS nou în consola browserului cu
document.querySelectorAll('...')înainte să-l pui în test. - Ține selectorii într-un Page Object, ca o greșeală să se repare într-un singur loc.
Întrebări frecvente
De ce nu apare eroarea la page.locator(), ci la click?
Locatorul e doar o descriere. Playwright parsează și caută elementul abia când faci o acțiune sau o aserțiune, de aceea eroarea apare pe linia cu click.
Ce face CSS.escape?
E o funcție din browser care adaugă \\ în fața caracterelor speciale dintr-un id sau o clasă, de ex. CSS.escape('1a') dă \\31 a. În teste e mai simplu să eviți id-urile ciudate și să folosești atribute sau getBy...
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. 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. 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. Î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.
