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

ReferenceError: By is not defined

Pe scurt

Folosești By.css(...) (sau until, Key) fără să-l fi importat din selenium-webdriver. Adaugă-l în import: const { Builder, By, until, Key } = require('selenium-webdriver');

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

Ce înseamnă

selenium-webdriver exportă mai multe obiecte separate: Builder (creează driverul), By (strategiile de căutare: css, id, xpath...), until (condițiile pentru driver.wait), Key (tastele speciale). Fiecare trebuie importat explicit. ReferenceError: By is not defined apare la prima linie care folosește By fără ca numele să existe în fișier.

Se întâmplă când pornești de la un exemplu care importa doar Builder, când muți o funcție ajutătoare (un Page Object) într-un fișier nou și uiți importurile, sau când scrii by.css cu literă mică. Eroarea apare în timpul testului, nu la încărcare, deci un test fără By poate trece, iar altul din același fișier pică. Mesajele until is not defined și Key is not defined au aceeași cauză.

De ce apare: cauzele frecvente

1By lipsește din import

Greșit
JavaScript
const { Builder } = require('selenium-webdriver');
await driver.findElement(By.css('[data-testid="logo"]'));
Corect
JavaScript
const { Builder, By, until } = require('selenium-webdriver');
await driver.findElement(By.css('[data-testid="logo"]'));

By e un export separat al pachetului. Importat, numele există în fișier.

2Fișier nou fără importuri

Greșit
JavaScript
// pages/CatalogPage.js
class CatalogPage {
  carduri() { return this.driver.findElements(By.css('.card')); }
}
Corect
JavaScript
// pages/CatalogPage.js
const { By } = require('selenium-webdriver');
class CatalogPage {
  carduri() { return this.driver.findElements(By.css('.card')); }
}

Fiecare fișier își face propriile importuri; ce e importat în test nu ajunge în Page Object.

3Literă mică

Greșit
JavaScript
driver.findElement(by.css('#email'));
Corect
JavaScript
driver.findElement(By.css('#email'));

Numele sunt case-sensitive: exportul se numește By.

Repară tu

Repară eroarea, direct în pagină

Testul Selenium antetul afișează logo-ul pică cu ReferenceError: By is not defined: importul din selenium-webdriver conține doar Builder. Completează importul cu ce folosește testul. Testul afișează textul logo-ului.

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

describe('Antet', function () {
  this.timeout(10000);
  let driver;

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

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

  it('antetul afișează logo-ul', async function () {
    await driver.get('http://localhost:3000/#/catalog');
    const logo = await driver.wait(until.elementLocated(By.css('[data-testid="logo"]')), 5000);
    console.log(await logo.getText());
  });
});
Indiciu

Uită-te ce nume din selenium-webdriver folosește testul.

Alte forme ale mesajului

  • ReferenceError: until is not defined
  • ReferenceError: Key is not defined
  • ReferenceError: by is not defined
  • ReferenceError: assert is not defined

Cum o eviți pe viitor

  • Pornește fiecare fișier Selenium cu importul complet: const { Builder, By, until, Key } = require('selenium-webdriver');.
  • Folosește un editor cu autocompletare pentru importuri (VS Code sugerează importul când scrii By).
  • Rulează ESLint cu regula no-undef, care semnalează numele nedefinite înainte de rulare.

Întrebări frecvente

De ce testul pică abia la acea linie, nu la început?

JavaScript caută numele By abia când execută linia. Până atunci, fișierul se încarcă normal.

Pot importa tot pachetul?

Da: const webdriver = require('selenium-webdriver'), apoi webdriver.By.css(...). Destructurarea e doar mai scurtă.

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.