TypeError: Invalid locator
findElement / findElements a primit un text simplu (de exemplu '#login') în loc de un locator By. Selenium nu ghicește tipul selectorului. Scrie driver.findElement(By.css('#login')), By.id('login'), By.xpath(...) etc.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În selenium-webdriver pentru JavaScript, findElement, findElements și condițiile din until primesc un locator: un obiect creat cu By (By.css, By.id, By.name, By.xpath, By.linkText, By.className...) sau un obiect de forma { css: '...' }. Un șir simplu, driver.findElement('#login'), nu spune cu ce strategie să caute, iar biblioteca îl refuză cu TypeError: Invalid locator (în laborator: InvalidArgumentError: invalid argument: locator must be a By).
Greșeala apare des la cei care vin din Playwright sau Cypress, unde page.locator('#login') și cy.get('#login') primesc direct selectorul CSS. Altă cauză: By nu e importat sau e importat greșit (const By = require('selenium-webdriver')), deci By.css nu e funcția corectă. Eroarea e imediată și arată linia din test.
De ce apare: cauzele frecvente
1Selector CSS dat ca text
const card = await driver.findElement('[data-testid="product-card"]');const card = await driver.findElement(By.css('[data-testid="product-card"]'));By.css spune strategia de căutare. Textul simplu nu e un locator.
2Obișnuința din Playwright
await driver.findElement('#email').sendKeys('ana@shoprapid.ro');await driver.findElement(By.id('email')).sendKeys('ana@shoprapid.ro');În Selenium, id-ul are strategia lui, By.id, fără #.
3By importat greșit
const By = require('selenium-webdriver');const { By, until } = require('selenium-webdriver');By e o proprietate a modulului. Destructurarea îl importă corect.
Repară eroarea, direct în pagină
Testul Selenium numără produsele pică imediat: findElements primește un text simplu în loc de locator (TypeError: Invalid locator; în laborator InvalidArgumentError: ... locator must be a By). Repară apelul ca testul să afișeze câte carduri de produs (data-testid="product-card") are catalogul.
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('numără produsele', async function () {
await driver.get('http://localhost:3000/#/catalog');
await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 5000);
const carduri = await driver.findElements('[data-testid="product-card"]');
console.log(carduri.length);
});
});Indiciu
Selenium are nevoie de strategia de căutare.
Reparația
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('numără produsele', async function () {
await driver.get('http://localhost:3000/#/catalog');
await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 5000);
const carduri = await driver.findElements(By.css('[data-testid="product-card"]'));
console.log(carduri.length);
});
});De ce merge
findElements('[data-testid="product-card"]') primea doar textul selectorului, fără strategie, deci biblioteca nu știa cum să caute și a refuzat apelul. By.css(...) spune că textul e un selector CSS. Cardurile sunt deja încărcate (le așteaptă until.elementLocated), deci lista are toate cele 8 elemente.
Alte forme ale mesajului
InvalidArgumentError: invalid argument: locator must be a By (de ex. By.css('#id'))TypeError: Invalid locator: [object Object]TypeError: By.css is not a function
Cum o eviți pe viitor
- Scrie locatorii Selenium într-un singur loc (Page Object), toți cu
By. - Importă
Byșiuntilprin destructurare:const { Builder, By, until } = require('selenium-webdriver'). - Când treci de la Playwright la Selenium (sau invers), verifică semnăturile: aici selectorul are nevoie de strategie.
Întrebări frecvente
Pot scrie { css: '...' } în loc de By.css?
Da, selenium-webdriver acceptă și obiecte simple ({ css: '#id' }, { xpath: '//a' }). By e varianta obișnuită și mai ușor de citit.
By.id('#login') merge?
Nu: By.id primește doar numele id-ului, fără #. # face parte din sintaxa CSS (By.css('#login')).
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. 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. InvalidArgumentError: invalid argument driver.get() a primit o adresă pe care browserul nu o poate deschide: de obicei o cale relativă (/#/login) sau o adresă fără http://. Selenium nu are baseURL; dă adresa completă, de exemplu driver.get('http://localhost:3000/#/login'), ținând partea fixă într-o constantă. Î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.
