ReferenceError: By is not defined
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
const { Builder } = require('selenium-webdriver');
await driver.findElement(By.css('[data-testid="logo"]'));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
// pages/CatalogPage.js
class CatalogPage {
carduri() { return this.driver.findElements(By.css('.card')); }
}// 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ă
driver.findElement(by.css('#email'));driver.findElement(By.css('#email'));Numele sunt case-sensitive: exportul se numește By.
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.
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.
Reparația
const { Builder, By, until } = 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());
});
});De ce merge
By și until sunt exporturi separate ale pachetului selenium-webdriver, iar fișierul le folosea fără să le importe, deci la prima linie cu By.css JavaScript nu găsea numele. Cu const { Builder, By, until } = require('selenium-webdriver'), ambele există, iar testul găsește logo-ul și îi citește textul.
Alte forme ale mesajului
ReferenceError: until is not definedReferenceError: Key is not definedReferenceError: by is not definedReferenceError: 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
ReferenceError: page is not defined Folosești variabila page într-un test (sau hook) care nu a cerut-o. page e un fixture: îl primești scriindu-l între acolade în parametrii funcției, async ({ page }) => { ... }. La fel pentru request, context sau browser. 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. ReferenceError: describe is not defined Fișierul de test Playwright folosește describe, it sau beforeEach ca în Jest / Mocha, dar Playwright Test nu le definește global. Folosește test.describe, test și test.beforeEach, importate din @playwright/test. Î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.
