...
Eroare Testare automată · Selenium WebDriver și Mocha

InvalidSelectorError: invalid selector: An invalid or illegal selector was specified

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul nu spune că elementul lipsește, ci că browserul nici nu a putut interpreta selectorul. ChromeDriver transmite selectorul CSS lui document.querySelector; dacă acesta aruncă o eroare de sintaxă, răspunsul este invalid selector: An invalid or illegal selector was specified. Pentru XPath greșit, mesajul devine Unable to locate an element with the xpath expression ... sau The string '...' is not a valid XPath expression.

Cele mai frecvente cauze: un XPath (//button[text()='Caută']) pus în By.css, pseudo-clase din jQuery sau Playwright care nu există în CSS (:contains("Caută"), :has-text(...), :visible), paranteze drepte sau ghilimele neînchise ([data-testid="x"), id-uri care încep cu cifră folosite cu # (#1-produs). Eroarea apare imediat, indiferent de pagină, deci e ușor de reprodus: lipește selectorul în consola browserului cu document.querySelector('...').

De ce apare: cauzele frecvente

1XPath dat lui By.css

Greșit
JavaScript
await driver.findElement(By.css("//button[text()='Caută']"));
Corect
JavaScript
await driver.findElement(By.xpath("//button[text()='Caută']"));

Expresiile care încep cu // sunt XPath. By.css le trimite la querySelector, care nu le înțelege.

2Pseudo-clasă care nu există în CSS

Greșit
JavaScript
await driver.findElement(By.css('button:contains("Caută")'));
Corect
JavaScript
await driver.findElement(By.xpath("//button[contains(., 'Caută')]"));

:contains e din jQuery, nu din CSS. Căutarea după text se face cu XPath (sau cu By.linkText pentru linkuri).

3Paranteză neînchisă

Greșit
JavaScript
await driver.findElement(By.css('[data-testid="search-input"'));
Corect
JavaScript
await driver.findElement(By.css('[data-testid="search-input"]'));

Selectorul de atribut trebuie închis cu ]. Fără ea, CSS-ul e invalid.

Repară tu

Repară eroarea, direct în pagină

Testul Selenium caută după text butonul de căutare pică cu InvalidSelectorError: invalid selector: un XPath e dat lui By.css. Repară locatorul ca să găsească butonul „Caută” după text (cu XPath), apoi testul apasă butonul și afișează rezultatul din role=status.

Codul care dă eroarea
JavaScript
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');

describe('Căutare', function () {
  let driver;

  before(async function () {
    driver = await new Builder().forBrowser('chrome').build();
  });

  after(async function () {
    await driver.quit();
  });

  it('caută după text butonul de căutare', async function () {
    await driver.get('http://localhost:3000/');
    await driver.findElement(By.css('#q')).sendKeys('laptop');
    await driver.findElement(By.css("//button[text()='Caută']")).click();
  });
});
Indiciu

Expresiile care încep cu // au metoda lor proprie în By.

Alte forme ale mesajului

  • InvalidSelectorError: invalid selector: Unable to locate an element with the xpath expression //button[ because of the following error:
  • InvalidSelectorError: invalid selector: The result of the xpath expression is: [object Text]. It should be an element.
  • org.openqa.selenium.InvalidSelectorException: invalid selector: An invalid or illegal selector was specified

Cum o eviți pe viitor

  • Testează selectorii în consola browserului: document.querySelector('...') pentru CSS, $x('...') pentru XPath.
  • Folosește By.css doar cu CSS standard și By.xpath pentru căutări după text.
  • Preferă atributele de test ([data-testid="..."]): sunt simple și greu de scris greșit.

Întrebări frecvente

De ce în Playwright merge :has-text?

Playwright are propriul motor de selectori, cu extensii (:has-text, :visible, text=). Selenium trimite selectorul direct browserului, care cunoaște doar CSS-ul standard.

Ce înseamnă „It should be an element” la XPath?

XPath-ul selectează un text sau un atribut (//button/text()), nu un element. Scoate partea /text() și citește textul cu getText().

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.