...
Eroare Node.js · Module CommonJS: require și module.exports

SyntaxError: Unexpected token 'export'

Pe scurt

Fișierul folosește export (sintaxa modulelor ES), dar Node îl rulează ca CommonJS, de obicei pentru că package.json are "type": "commonjs" sau fișierul are extensia .cjs. Fie scrii exporturile cu module.exports, fie treci proiectul pe module ES cu "type": "module".

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

Ce înseamnă

Node are două sisteme de module: CommonJS (require și module.exports) și module ES (import și export). Un fișier e citit ca CommonJS dacă are extensia .cjs sau dacă cel mai apropiat package.json conține "type": "commonjs". În CommonJS, cuvântul export nu înseamnă nimic, așa că parserul se oprește la el: Unexpected token 'export'.

De la Node 22, un fișier .js fără "type" în package.json e analizat automat: dacă are sintaxă ES, e rulat ca modul ES. Dar npm init scrie acum implicit "type": "commonjs", iar cu tipul declarat explicit detecția automată nu mai are loc.

Mesajul arată fișierul și linia, cu ^^^^^^ sub export. Dacă fișierul e în node_modules, înseamnă că un pachet ES e încărcat ca CommonJS (de exemplu de Jest sau de un instrument vechi), nu că ai greșit tu în cod.

De ce apare: cauzele frecvente

1Exporturi ES într-un proiect CommonJS

Greșit
JavaScript
export function formatLei(suma) {
  return `${suma.toFixed(2)} lei`;
}
Corect
JavaScript
function formatLei(suma) {
  return `${suma.toFixed(2)} lei`;
}

module.exports = { formatLei };

În CommonJS exporturile se pun pe module.exports. Restul proiectului le citește cu require.

2Proiectul ar trebui să fie pe module ES

Greșit
JavaScript
{
  "name": "magazin",
  "type": "commonjs"
}
Corect
JavaScript
{
  "name": "magazin",
  "type": "module"
}

Cu "type": "module", toate fișierele .js sunt module ES și export e valid. Atunci și require trebuie înlocuit peste tot cu import.

3Un pachet ES rulat de un instrument care așteaptă CommonJS

Greșit
JavaScript
// jest.config.js fără transformare pentru node_modules
// /app/node_modules/pachet/index.js:1
// export default function () {}
Corect
JavaScript
// folosește versiunea CommonJS a pachetului
// sau configurează instrumentul pentru module ES

Când eroarea arată un fișier din node_modules, problema e la cel care îl încarcă: alege o versiune a pachetului care oferă și CommonJS sau activează suportul pentru module ES.

Repară tu

Repară eroarea, direct în pagină

Proiectul are "type": "commonjs" în package.json, iar index.js dă SyntaxError: Unexpected token 'export', pentru că funcția formatLei a fost copiată dintr-un proiect cu module ES. Rescrie exportul în stil CommonJS, ca programul să afișeze totalul fiecărei comenzi.

Codul care dă eroarea
JavaScript
const fs = require("fs");

export function formatLei(suma) {
  return `${suma.toFixed(2)} lei`;
}

const comenzi = JSON.parse(fs.readFileSync("comenzi.json", "utf8"));
for (const c of comenzi) {
  console.log(`${c.client}: ${formatLei(c.total)}`);
}
După reparație, programul afișează
Ana: 125.50 lei
Mihai: 89.00 lei
Indiciu

Scoate cuvântul export din fața funcției și adaugă la final module.exports = { formatLei };.

Alte forme ale mesajului

  • SyntaxError: Unexpected token 'export' at wrapSafe (node:internal/modules/cjs/loader)
  • SyntaxError: Unexpected token export
  • /app/node_modules/pachet/index.js:1 export default function () {} ^^^^^^ SyntaxError: Unexpected token 'export'

Cum o eviți pe viitor

  • Alege un singur sistem de module pentru proiect și scrie-l explicit în package.json ("type": "module" sau "type": "commonjs").
  • Când copiezi cod de pe internet, verifică dacă e scris cu import/export sau cu require/module.exports.
  • Folosește extensiile .mjs și .cjs pentru fișierele care trebuie să fie de celălalt tip decât restul proiectului.

Întrebări frecvente

De ce merge fără package.json și pică după npm init?

Fără "type", Node 22+ detectează singur sintaxa ES și rulează fișierul ca modul ES. npm init adaugă "type": "commonjs", iar de atunci fișierul e tratat strict ca CommonJS.

Pot folosi export și require în același fișier?

Nu. Un fișier e fie CommonJS, fie modul ES. Într-un modul ES poți obține totuși un require cu createRequire(import.meta.url) din modulul node:module.

Erori înrudite

← Toate erorile Node.js

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ță Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.