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

TypeError: Invalid locator

Pe scurt

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

Greșit
JavaScript
const card = await driver.findElement('[data-testid="product-card"]');
Corect
JavaScript
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

Greșit
JavaScript
await driver.findElement('#email').sendKeys('ana@shoprapid.ro');
Corect
JavaScript
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

Greșit
JavaScript
const By = require('selenium-webdriver');
Corect
JavaScript
const { By, until } = require('selenium-webdriver');

By e o proprietate a modulului. Destructurarea îl importă corect.

Repară tu

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.

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

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 și until prin 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

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