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

SyntaxError: Cannot use import statement outside a module

Pe scurt

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

Greșit
JavaScript
import { Builder, By, until } from 'selenium-webdriver';
import assert from 'node:assert';
Corect
JavaScript
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

Greșit
JavaScript
// package.json
{ "devDependencies": { "mocha": "^10.0.0" } }
Corect
JavaScript
// 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

Greșit
JavaScript
export class LoginPage {}
Corect
JavaScript
class LoginPage {}
module.exports = { LoginPage };

export e tot sintaxă ES modules; în CommonJS exporți prin module.exports.

Repară tu

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.

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

Alte forme ale mesajului

  • SyntaxError: Unexpected token 'export'
  • ReferenceError: require is not defined in ES module scope, you can use import instead
  • Warning: 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. chai 5), folosește proiect ESM sau import() 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

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