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.
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
await driver.findElement(By.css("//button[text()='Caută']"));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
await driver.findElement(By.css('button:contains("Caută")'));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ă
await driver.findElement(By.css('[data-testid="search-input"'));await driver.findElement(By.css('[data-testid="search-input"]'));Selectorul de atribut trebuie închis cu ]. Fără ea, CSS-ul e invalid.
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.
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.
Reparația
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.xpath("//button[text()='Caută']")).click();
console.log(await driver.findElement(By.css('[role="status"]')).getText());
});
});De ce merge
By.css("//button[text()='Caută']") trimitea un XPath motorului CSS al browserului, care l-a respins ca selector invalid, înainte de orice căutare. By.xpath(...) folosește motorul XPath, care înțelege //button[text()='Caută'] și găsește butonul după textul lui.
Click-ul scrie apoi în role=status rezultatul căutării. Pentru butoane cu data-testid, By.css('[data-testid="..."]') ar fi la fel de bun și mai stabil decât textul.
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.cssdoar cu CSS standard șiBy.xpathpentru 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
NoSuchElementError: no such element: Unable to locate element: {"method":"css selector","selector":"[data-testid=\"product-card\"]"} driver.findElement nu a găsit elementul în momentul apelului: Selenium nu așteaptă implicit. Dacă elementul apare după încărcare, așteaptă-l cu driver.wait(until.elementLocated(By.css('...')), 5000); dacă nu apare niciodată, selectorul e greșit. TimeoutError: Waiting for element to be located By(css selector, #cautare)
Wait timed out after 5000ms driver.wait(until.elementLocated(...)) a așteptat tot timpul dat și elementul nu a apărut. Așteptarea e corectă, dar selectorul nu se potrivește cu nimic în pagină (alt id, alt atribut, altă pagină). Corectează locatorul după HTML-ul real; mărește timpul doar dacă elementul chiar apare târziu. Error: locator.fill: Error: Element is not an <input>, <textarea> or [contenteditable] element Ai apelat fill() pe un element în care nu se poate scrie, de exemplu pe div-ul care înconjoară câmpul, pe un paragraf sau pe un buton. Găsește chiar câmpul de text: getByLabel('Email'), getByRole('textbox', { name }) sau getByPlaceholder(). Î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.
