SyntaxError: Cannot use import statement outside a module
Fișierul de test folosește import (ES modules), dar Node îl încarcă drept CommonJS: package.json nu are "type": "module", iar extensia e .js. Fie scrii require(...), fie adaugi "type": "module" în package.json (sau redenumești fișierele în .mjs).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Node are două sisteme de module: CommonJS (require, module.exports), implicit pentru fișierele .js, și ES modules (import, export), activ pentru .mjs sau pentru .js când package.json are "type": "module". Mocha încarcă testele cu Node, deci un import { Builder } from 'selenium-webdriver' într-un .js fără type: module dă eroarea de sintaxă la prima linie, înainte să ruleze vreun test.
Playwright Test își transformă singur fișierele, de aceea acolo import merge și fără setări; diferența apare când treci la Mocha + Selenium sau când rulezi un script direct cu node. Varianta inversă există și ea: require is not defined in ES module scope (ai type: module, dar scrii require). Alege un singur stil pe proiect.
De ce apare: cauzele frecvente
1import într-un proiect CommonJS
import { Builder, By, until } from 'selenium-webdriver';
import assert from 'node:assert';const { Builder, By, until } = require('selenium-webdriver');
const assert = require('node:assert');Fără type: module, fișierele .js sunt CommonJS și folosesc require.
2Proiect care vrea ES modules
// package.json
{ "devDependencies": { "mocha": "^10.0.0" } }// package.json
{ "type": "module", "devDependencies": { "mocha": "^10.0.0" } }type: module spune lui Node să trateze .js drept ES modules, deci import devine valid.
3export într-un Page Object CommonJS
export class LoginPage {}class LoginPage {}
module.exports = { LoginPage };export e tot sintaxă ES modules; în CommonJS exporți prin module.exports.
Repară eroarea, direct în pagină
Proiectul Selenium + Mocha e CommonJS (fără "type": "module" în package.json), dar testul pagina principală se deschide folosește import, deci Mocha pică la încărcare cu Cannot use import statement outside a module. Rescrie importurile în stilul CommonJS. Testul afișează titlul paginii principale.
import { Builder, By, until } from 'selenium-webdriver';
import assert from 'node:assert';
describe('Acasă', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('pagina principală se deschide', async function () {
await driver.get('http://localhost:3000/');
const titlu = await driver.findElement(By.css('h1')).getText();
assert.strictEqual(titlu, 'Bine ai venit la ShopRapid');
console.log(titlu);
});
});Indiciu
CommonJS folosește require.
Reparația
const { Builder, By, until } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Acasă', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('pagina principală se deschide', async function () {
await driver.get('http://localhost:3000/');
const titlu = await driver.findElement(By.css('h1')).getText();
assert.strictEqual(titlu, 'Bine ai venit la ShopRapid');
console.log(titlu);
});
});De ce merge
Node tratează un fișier .js ca CommonJS când package.json nu spune altceva, iar în CommonJS import e o eroare de sintaxă, deci fișierul nu se încărca deloc. Cu require('selenium-webdriver') și require('node:assert'), fișierul e valid, Mocha îl încarcă, iar testul rulează și afișează titlul.
Alte forme ale mesajului
SyntaxError: Unexpected token 'export'ReferenceError: require is not defined in ES module scope, you can use import insteadWarning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension.Error [ERR_REQUIRE_ESM]: require() of ES Module node_modules/chai/lib/chai.js not supported.
Cum o eviți pe viitor
- Alege la începutul proiectului un singur sistem de module și scrie-l în
package.json("type": "module"sau nimic). - Când copiezi exemple, adaptează importurile la stilul proiectului.
- Pentru biblioteci noi care sunt doar ES modules (de ex.
chai5), folosește proiect ESM sauimport()dinamic.
Întrebări frecvente
De ce în Playwright import merge fără type: module?
Playwright Test trece fișierele de test printr-un transformator propriu (Babel), care convertește import când e nevoie. Mocha nu face asta: lasă totul pe seama lui Node.
Ce e ERR_REQUIRE_ESM?
Încerci să încarci cu require un pachet care există doar ca ES module. Soluția: proiect ESM, import() dinamic sau o versiune mai veche a pachetului, care are și CommonJS.
Erori înrudite
Error: Cannot find module './pages/LoginPage.js' imported from tests/exemplu.spec.js Calea din import nu duce la niciun fișier: e relativă la alt folder decât crezi, numele are altă literă mare sau extensia lipsește. Căile relative pornesc din folderul fișierului care importă, deci din tests/ ajungi la pages/ cu ../pages/LoginPage.js. TypeError: LoginPage is not a constructor Ce ai importat sub numele LoginPage nu e clasa: exportul și importul nu se potrivesc. Clasa exportată cu export default se importă fără acolade (import LoginPage from ...), iar cea cu export class sau module.exports = { LoginPage } se importă cu acolade. 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'); Î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.
