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

Error: locator.click: Unexpected token "]" while parsing css selector "button[data-testid=add-to-cart]]". Did you mean to CSS.escape it?

Pe scurt

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

Greșit
JavaScript
await page.locator('button[data-testid=add-to-cart]]').first().click();
Corect
JavaScript
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

Greșit
JavaScript
page.locator('[aria-label=Adaugă în coș]')
Corect
JavaScript
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ă

Greșit
JavaScript
page.locator('#123-produs')
Corect
JavaScript
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ă tu

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.

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

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

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